Skip to content
Development
Skill

/customer-research

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

From plugin
erpaval
2911 skills4 agents3 hooks5 MCP

Claude Code

$ npx -y skills add laithalsaadoon/erpaval --skill customer-research --agent claude-code

SKILL.md

customer-research.SKILL.md
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.

Contents

| 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 |

Customer Research

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 to Use

  • You have a vague customer pain and need to know if it's real, at scale, and root-caused correctly.
  • You need to produce a problem statement for a PR/FAQ or long-form narrative.
  • You need to build a customer journey map for a design review.
  • You have interview transcripts or survey data and need to synthesize them into decision-ready findings.
  • You need to design a research plan before committing to a study (interviews, A/B test, survey).

When NOT to use:

  • The customer problem is already well-framed and data-backed → go straight to `skills/working-backwards/` or `skills/product-discovery/`.
  • You need writing critique for an existing prompt or document → `skills/meta-prompt-optimizer/`.

Core Concepts

The method: research-design

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.

Pyramid connection

This skill *produces* the Pyramid base. Downstream skills *compose* it:

  • `working-backwards` uses the findings for the 5CQ's Q1, Q2, Q4 and the PR's Situation + Complication.
  • `product-discovery` uses the findings for its research-scout role.
  • A narrative-writing workflow of your choice composes a long-form document or one-pager from the findings.

Keeping findings in a structured shape means downstream composition becomes mechanical translation, not improvisation.

Three artifacts ship from this skill

| 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 |

Quick Reference

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. **

Read more
@theagenticguy
Ships witherpaval

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.

2911 skills4 agents5 MCP
Get the whole plugin

Stars on GitHub

Momentum

stars in total
29
Star history of theagenticguy/erpaval on GitHub, a chart by star-history.com

Other skills on erpaval.

erpaval

erpaval

Workflow for autonomous software development with Claude Code. Classifiers route scope, complexity, directory state, and spec…

agent-ux-patterns

agent-ux-patterns

Agent UX patterns and human-in-the-loop design: Twilio A2H protocol, Levels of Autonomy (L0-L5), inbox pattern, progressive…

More skills from other plugins.

brainstorming
Auto-invoked

brainstorming

You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or…

@obra@obraInstall Skill
ask-matt

ask-matt

Ask which skill or flow fits your situation. A router over the skills in this repo.

skills2w309k
@mattpocock@mattpocockInstall Skill
accessibility
Auto-invoked

accessibility

Design, implement, and audit accessible UI to WCAG 2.2 Level AA across Web, iOS, and Android — semantic ARIA roles and labels,…

ecc2w293k
@affaan-m@affaan-mInstall Skill
compiler-commit

compiler-commit

Use when you want to verify compiler changes and commit with the correct convention. Runs tests, lint, and format, then commits…

react5d252k
@facebook@facebookInstall Skill

Questions about customer-research.

Which coding agents can use customer-research?
customer-research installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.