problem-framing
Problem Framing
Transform raw product ideas into structured context that coding agents can execute on.
Why This Exists
Extracts fuzzy product ideas from the user's head and structures them into clear problem statements, target users, and assumptions that coding agents can execute against.
Workflow
Step 1: Gather Raw Input
Ask the user to share their idea in any form—plain text, voice dump, bullet points, or existing notes. Accept whatever they have.
Step 2: Run the Question Flow
Work through these questions conversationally. Skip or adapt based on what the user has already provided.
| Question | Purpose |
|---|---|
| What are you trying to build? | Get the raw idea out |
| Who specifically is this for? | Force specificity—"everyone" = no one |
| What problem does this solve for them? | Separate solution from problem |
| What are they doing today without this? | Reveals current alternatives, competition |
| When does this problem hit hardest? | Identifies trigger moments, urgency |
| What assumptions are you making? | Surfaces risks early |
| How will you know this worked? | Defines success criteria |
Questioning style:
- Ask one question at a time
- Probe vague answers ("Can you be more specific about who?")
- Reflect back what you hear to confirm understanding
- Don't overwhelm—adapt based on what's already clear
Step 3: Generate Output
Once you have enough context, generate the structured output below. Automatically save it to design/01-problem-framing.md using the Write tool while continuing the conversation naturally.
Output Format
# Problem Framing: [Project Name]
## Problem Statement
[One clear sentence: WHO has WHAT problem WHEN]
## Target User
[Specific description—not "everyone" or "users"]
## Jobs to Be Done
- **Functional:** [What they're trying to accomplish]
- **Emotional:** [How they want to feel]
- **Social:** [How they want to be perceived]
## Current Alternatives
[What they do today without your solution]
## Trigger Moments
[When does this problem hit hardest?]
## Key Assumptions
- [Assumption 1]
- [Assumption 2]
- [Assumption 3]
## Success Criteria
- [How you'll measure if this works]
## Open Questions
- [Anything still unclear or needing validation]
Handoff
After presenting the output, ask:
"This captures your problem framing. Ready to move to
/user-modeling,/solution-scoping, or/prd-generation, or want to refine anything first?"
Note: File is automatically saved to design/01-problem-framing.md for context preservation.