refactor: simplify questioning to four essentials

Focus on what to extract, not what to avoid:
- What they're building
- Why it needs to exist
- Who it's for
- What done looks like

Remove version drag and redundant question categories.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Lex Christopherson
2026-01-14 23:32:21 -06:00
parent d5ff9a4531
commit e6bdd26118

View File

@@ -33,15 +33,11 @@ A vague PROJECT.md forces every downstream phase to guess. The cost compounds.
**Challenge vagueness.** Never accept fuzzy answers. "Good" means what? "Users" means who? "Simple" means how?
**Make the abstract concrete.** "Walk me through using this." "What happens when X?" "What does that actually look like?"
**Make the abstract concrete.** "Walk me through using this." "What does that actually look like?"
**Surface assumptions.** "You haven't mentioned Y — is that intentional?" "When you say Z, do you mean A or B?"
**Clarify ambiguity.** "When you say Z, do you mean A or B?" "You mentioned X — tell me more."
**Find the edges.** "What would make this feel bloated?" "What's the simplest version that's still useful?"
**Reveal motivation.** "What prompted this?" "What are you doing today that this replaces?"
**Know when to stop.** When you could write a clear PROJECT.md that downstream phases can act on, offer to.
**Know when to stop.** When you understand what they want, why they want it, who it's for, and what done looks like — offer to proceed.
</how_to_question>
@@ -49,37 +45,23 @@ A vague PROJECT.md forces every downstream phase to guess. The cost compounds.
Use these as inspiration, not a checklist. Pick what's relevant to the thread.
**Motivation:**
**Motivation — why this exists:**
- "What prompted this?"
- "What are you doing today that this replaces?"
- "What would you do if this existed?"
- "Why does this need to exist?"
**Concreteness:**
**Concreteness — what it actually is:**
- "Walk me through using this"
- "What happens when [edge case]?"
- "You said X — what does that actually look like?"
- "Give me an example"
**Boundaries:**
- "What would make this feel bloated?"
- "What's the simplest version that's still useful?"
- "What would you cut if you had to ship tomorrow?"
**Assumptions:**
- "You haven't mentioned Y — is that intentional?"
**Clarification — what they mean:**
- "When you say Z, do you mean A or B?"
- "What are you assuming I already know?"
- "You mentioned X — tell me more about that"
**Reality:**
- "What exists already that this touches?"
- "What's already decided?" (tech, platform, integrations)
- "What would make this impossible?"
**Success:**
**Success — how you'll know it's working:**
- "How will you know this is working?"
- "What does done look like?"
- "What would make this obviously successful?"
</question_types>
@@ -115,22 +97,14 @@ User mentions "frustrated with current tools"
<context_checklist>
Use this as a **background checklist**, not a conversation structure. Check these boxes mentally as you go. If gaps remain near the end, weave questions naturally — don't suddenly switch to checklist mode.
Use this as a **background checklist**, not a conversation structure. Check these mentally as you go. If gaps remain, weave questions naturally.
- [ ] What they're building (concrete enough to explain to a stranger)
- [ ] Why it needs to exist (the problem or desire driving it)
- [ ] Who it's for (even if just themselves)
- [ ] What "done" looks like (observable outcomes)
That's it. Four things.
**NOT your job to extract:**
- Scope boundaries → research and roadmapping determine this
- Constraints → emerge from implementation
- Tech stack → research decides this
- What they already know → irrelevant, Claude researches regardless
If they volunteer this information, capture it. Don't ask for it.
Four things. If they volunteer more, capture it.
</context_checklist>