erpaval
Workflow for autonomous software development with Claude Code. Classifiers route scope, complexity, directory state, and spec readiness before committing to…
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
$ npx -y skills add theagenticguy/erpaval --skill customer-research --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
/customer-researchContext preview
The summary Claude sees to decide when to auto-load this skill.
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
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.
Repo: theagenticguy/erpaval
Workflow for autonomous software development with Claude Code. Classifiers route scope, complexity, directory state, and spec readiness before committing to…
Shared canonical references for product-design frameworks — Pyramid Principle, Working Backwards, Double Diamond, research design, methodology selection.…
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 trust, decision journal, gate…
Audit and rewrite prompts against Claude Opus 4.7 instruction-following best practices. Produces a scored audit plus a rewritten prompt. Use when the user asks…