erpaval
Workflow for autonomous software development with Claude Code. Classifiers route scope, complexity, directory state, and spec…
Customer research and problem framing using the research-design discipline: hypothesis, null hypothesis, MECE questions, methods, findings. Produces Pyramid-base-shaped output ready for downstream composition into PR/FAQs, long-form narratives, or PRDs. Use when the user asks to
Claude Code
$ npx -y skills add laithalsaadoon/erpaval --skill customer-research --agent claude-code
Codex
$ npx skills add laithalsaadoon/erpaval --skill customer-research -a codex -y
Cursor
$ npx skills add laithalsaadoon/erpaval --skill customer-research -a cursor -y
Gemini CLI
$ npx skills add laithalsaadoon/erpaval --skill customer-research -a gemini-cli -y
GitHub Copilot
$ npx skills add laithalsaadoon/erpaval --skill customer-research -a github-copilot -y
OpenCode
$ npx skills add laithalsaadoon/erpaval --skill customer-research -a opencode -y
Windsurf
$ npx skills add laithalsaadoon/erpaval --skill customer-research -a windsurf -y
name: customer-research description: > Customer research and problem framing using the research-design discipline: hypothesis, null hypothesis, MECE questions, methods, findings. Produces Pyramid-base-shaped output ready for downstream composition into PR/FAQs, long-form narratives, or PRDs. Use when the user asks to design user research, run customer interviews, synthesize research findings, frame a problem statement, build a customer journey map, plan a VoC study, or mentions pain-point analysis, research plan, hypothesis testing, customer insights, jobs-to-be-done, or voice of customer.
| File | Path | When to load | | ------------------------------------- | -------------------------------------------------------------------------------------- | ------------------------------------------------------------- | | Research design method | `${CLAUDE_PLUGIN_ROOT}/skills/product-design-shared/references/research-design.md` | Hypothesis + null + MECE + findings | | Pyramid composition | `${CLAUDE_PLUGIN_ROOT}/skills/product-design-shared/references/pyramid-principle.md` | Where findings get composed into arguments | | Canonical Working Backwards reference | `${CLAUDE_PLUGIN_ROOT}/skills/product-design-shared/references/working-backwards.md` | Listen + Define stage context | | Research methods | `references/research-methods.md` | Interview protocols, affinity clustering, qual/quant taxonomy | | Customer-insights role | `${CLAUDE_PLUGIN_ROOT}/skills/working-backwards/references/roles/customer-insights.md` | Researcher agent for Listen-stage execution | | Research plan template | `templates/research-plan.md` | Hypothesis, null, MECE questions, methods, findings (fill-in) | | Problem statement template | `templates/problem-statement.md` | "Today [customers] have to..." | | Customer journey map template | `templates/customer-journey-map.md` | Phase / action / touchpoint / thought / feeling / opportunity |
The discipline of framing a testable hypothesis, gathering evidence via MECE sub-questions, and synthesizing findings into a shape the Pyramid Principle can compose. This is the *research bottom-up* half of Minto's core instruction — the upstream of `working-backwards` and any narrative composition.
When NOT to use:
The load-bearing reference is `${CLAUDE_PLUGIN_ROOT}/skills/product-design-shared/references/research-design.md`. Five steps:
1. **Hypothesis** — one testable claim in one sentence. 2. **Null hypothesis** — the outcome that would disprove it. Pre-commit before gathering. 3. **MECE sub-questions** — 3–5 questions that collectively test the hypothesis without overlap. 4. **Methods per question** — behavioral, attitudinal, pain-point texture, segmentation, scale, causal. 5. **Findings in Pyramid-base shape** — per sub-question: Finding + Evidence + So what + Confidence.
The shape of your output is not optional. Pyramid-base-shaped findings feed `pyramid-principle.md` Phase 1 by construction.
This skill *produces* the Pyramid base. Downstream skills *compose* it:
Keeping findings in a structured shape means downstream composition becomes mechanical translation, not improvisation.
| Artifact | Template | When | | -------------------- | ----------------------------------- | ------------------------------------------------------------------ | | Research plan | `templates/research-plan.md` | Before gathering — pre-commit the hypothesis and null | | Problem statement | `templates/problem-statement.md` | After Define — the Listen output used by WB Stage 2 | | Customer journey map | `templates/customer-journey-map.md` | When you need to visualize current-state pain points across a flow |
A typical customer-research run:
1. **Capture intent.** What is the fuzzy question? Who is the primary customer segment? 2. **Frame the hypothesis + null.** Use `templates/research-plan.md`. Pre-commit in writing. 3. **Decompose MECE.** 3–5 sub-questions. Test: "Can I answer Q1 without answering Q2?" 4. **Pick methods per question** (see `references/research-methods.md` for the taxonomy). 5. **
Autonomous software development for Claude Code. ERPAVal stands for Explore · Research · Plan · Act · Validate — the five-phase loop, plus a sixth Compound phase that writes durable lessons to disk so the next session inherits what this one learned.
Workflow for autonomous software development with Claude Code. Classifiers route scope, complexity, directory state, and spec…
Shared canonical references for product-design frameworks — Pyramid Principle, Working Backwards, Double Diamond, research…
Optional path to raw content (brief, notes, tickets) or a one-line topic.
Agent UX patterns and human-in-the-loop design: Twilio A2H protocol, Levels of Autonomy (L0-L5), inbox pattern, progressive…
Audit and rewrite prompts against Claude Opus 4.7 instruction-following best practices. Produces a scored audit plus a rewritten…
You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or…
Ask which skill or flow fits your situation. A router over the skills in this repo.