research-plan
Skill11 starsChanged 11 days agoMITView on GitHub
Construct comprehensive research plans with goals, hypotheses, cohort definitions, methodology, and a 2-part interview guide (Profile + Behavioral). Use when the user says "I need to interview users about X", "create a research plan", "what questions should I ask", or invokes /research-plan.
6 other projects use a version of this.
Adopted by
Most recently taken up by
- tatashbar/Economic-Modeling-Studiotheir own version, first seen Nov 16, 2026
- miguelclavel/ux-research-skillstheir own version, first seen Nov 8, 2026
- tsingyuai/scientifytheir own version, first seen Oct 8, 2026
- dongzhigang13305312738-art/paper-skillstheir own version, first seen Jul 21, 2026
- TenureAI/PhD-Zerotheir own version, first seen Mar 31, 2026
- huangwb8/ChineseResearchLaTeXtheir own version, first seen Mar 17, 2026
Other versions6 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 6
- huangwb8/ChineseResearchLaTeX★ 3ksame name
- tsingyuai/scientify★ 2.2ksame name
- TenureAI/PhD-Zero★ 52same name
- tatashbar/Economic-Modeling-Studio★ 4same name
- dongzhigang13305312738-art/paper-skills★ 1same name
- miguelclavel/ux-research-skills★ 1same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository44 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- analyze-dataSkill
- brainstormingSkill
- craft-lessonSkill
- create-agentSkill
- create-skillSkill
- customize-agentSkill
- customize-skillSkill
- designSkill
- deslopSkill
- developSkill
- discovery-reportSkill
- elicitationSkill
- empathy-mapSkill
- explore-ideaSkill
- grill-meSkill
- help-meSkill
- humanizeSkill
- incidentSkill
- iterateSkill
- journey-mapSkill
- jtbdSkill
- kanbanSkill
- launchSkill
- legal-safety-auditSkill
- maintenance-executeSkill
- maintenance-planSkill
- memorySkill
- motionSkill
- phaseSkill
- planSkill
- retroSkill
- reviewSkill
- root-causeSkill
- round-tableSkill
- shape-upSkill
- shut-upSkill
- statusSkill
- teach-meSkill
- testSkill
- unpack-problemSkill
- validate-ideaSkill
- validation-patternsSkill
The file
We split this skill into the rules it gives an agent
5 rules. 0 are common, 5 are distinctive, and 0 are very specific to this project.
0
Common
Most of the 3 edited versions we read keep these.
5
Distinctive
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 22
Before conducting any primary research
- Distinctive: line 28
Ask: what do you need to learn?
- Distinctive: line 49
Ask about past specific behavior, not future hypotheticals: "Tell me about the last time you..." (NOT "Would you...")
- Distinctive: line 51
Avoid pitching: "How do you currently handle this?" (NOT "Would you use our solution?")
- Distinctive: line 128
At completion: Write session summary — mandatory:
“Common” is measured: kept by at least 6 in 10 of the 3 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Research Plan
What this skill does
Builds a structured research plan for validating product hypotheses. Outputs to artifacts/output/02-research/research-plan.md.
Persona delegation
This skill delegates to @user-researcher. The researcher designs the plan (goals, methodology, interview guides). The skill provides structure; @user-researcher provides research methodology expertise.
When to use
- "I need to interview users about X"
- "Create a research plan for validating our hypothesis"
- "What questions should I ask in user interviews?"
- Before conducting any primary research
Workflow
Step 1: Define research goals
Ask: what do you need to learn? Define 1-3 clear research goals. Each goal must be falsifiable — you should be able to learn that you're wrong.
Step 2: Define cohort
Who should be interviewed/surveyed? Define:
- Target segment: demographics, role, behavior criteria
- Sample size: minimum 5 for qualitative, 30+ for quantitative signals
- Recruitment method: how will you find them?
Step 3: Select methodology
Choose from: qualitative interviews, surveys, usability testing, card sorting, diary studies, A/B testing. Recommend based on goals and cohort. Explain why this method fits.
Step 4: Build interview guide (2-part)
Part 1: User Profile Questions
- Demographics, background, role, current tools
- "Tell me about your typical workflow for {task}."
- "What tools do you currently use?"
Part 2: Behavioral Questions (The Mom Test rules)
- Ask about past specific behavior, not future hypotheticals: "Tell me about the last time you..." (NOT "Would you...")
- Listen for commitment signals: "How have you tried to solve this before?"
- Avoid pitching: "How do you currently handle this?" (NOT "Would you use our solution?")
Step 5: Output
Write artifacts/output/02-research/research-plan.md:
# Research Plan — {topic}
**Date:** YYYY-MM-DD
**Methodology:** {approach}
**Hypothesis:** {the claim being validated — or "no prior hypothesis; exploratory"}
## Research Goals
1. {goal} — falsifiable? Yes/No
2. {goal} — falsifiable? Yes/No
## Cohort
- **Segment:** {description}
- **Sample size:** {N}
- **Recruitment:** {method}
## Method
{selected method + rationale}
## Interview Guide
### Part 1: Profile Questions
1. {question}
### Part 2: Behavioral Questions
1. "Tell me about the last time you {action}..."
2. "How have you tried to solve {problem} before?"
3. "Walk me through your current process for {task}."
### Mom Test Validation
- [ ] Questions ask about past behavior, not future intent
- [ ] No solution pitching in questions
- [ ] Commitment signals are probed
## Sampling Bias
{who is deliberately NOT being asked, and why}Done when — checked mechanically
This skill shipped with no gate, and three of its own rules were pure self-certification: goals
recorded as falsifiable? Yes/No filled in by the plan's own author, a Mom Test checkbox block the
same author ticks, and a sample-size floor nothing read. All three are checkable.
node .agents/scripts/research_plan_check.js check \
--file artifacts/output/02-research/research-plan.md --json| Rule | What is checked |
| What it validates | a **Hypothesis:** field or a named upstream artifact (validation-brief.md) — or an explicit statement that this is exploratory. The skill exists to validate hypotheses and previously never linked to one, so a plan could validate nothing |
| Goals | 1–3, each carrying an observable — a quantity, a direction, or a threshold. A self-declared falsifiable? Yes with nothing behind it is rejected |
| Cohort | segment, a numeric sample size at the floor this skill itself sets (5 qualitative / 30 quantitative, by method), and a recruitment method |
| Interview guide | both halves present, at least two questions each |
| The Mom Test — on the questions, not the checkbox | no future-intent phrasing ("would you", "do you think you would", "how much would you pay"), no solution pitching, and a past-behaviour probe actually present in Part 2. Ticking the boxes does not help; the boxes are verified against the questions |
| Sampling bias | a statement of who is deliberately not being asked. A cohort of people who already like the idea produces findings that confirm it, and nothing in the document distinguished that from a result |
What it does not check: whether the questions are any good, whether the cohort is reachable, or whether the study would actually settle the question. Those need a researcher.
Exit 0 conformant · 1 failures · 2 usage/IO error, fail-closed.
State machine integration
At start: Run node .agents/scripts/orchestrator_state.js status
At end: Run node .agents/scripts/orchestrator_state.js complete --agent user-researcher --artifact 02-research/research-plan.md
Memory integration
At start: Load context before defining research goals:
@memory-controller load user-researcher [research-plan — {research topic}]At completion: Write session summary — mandatory:
@memory-controller session-write [agent: @user-researcher]
Worked on: Research plan — {topic}
Decisions: Methodology: {chosen method}. Cohort: {target segment, N={size}}. Goals: {1-3 falsifiable goals}
Next step: Conduct research sessions, then load /explore-idea or /unpack-problem with findings
Blockers: {recruitment blockers or "none"}Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

