mattgierhart/PRD-driven-context-engineering / .claude/skills/prd-v01-problem-framing
prd-v01-problem-framing
VerifiedTransform vague product ideas into evidence-anchored problem statements for PRD v0.1 Spark. Triggers on starting new products/features, validating market opportunities, drafting PRD Why sections, or requests like "frame the problem", "define pain points", "write problem statement", "start v0.1", "what problem are we solving". Outputs structured problem tables with CFD evidence IDs.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 6.9 KB |
| assets/problem-statement.md | markdown | 2.9 KB |
| references/examples.md | markdown | 4.8 KB |
| references/research-prompts.md | markdown | 5.4 KB |
assets/problem-statement.md
View on GitHub# Problem Statement Template
Copy and populate for each new PRD v0.1 Spark.
---
## Gap Assessment Table
| Element | Status | Source |
|---------|--------|--------|
| Who is hurting? | ⚠️ Hypothesis / ✅ Validated / ❌ Missing | |
| What pain exists? | ⚠️ / ✅ / ❌ | |
| Cost of problem | ⚠️ / ✅ / ❌ | |
| Why now? | ⚠️ / ✅ / ❌ | |
| What's impossible? | ⚠️ / ✅ / ❌ | |
**Gate check**: ≥2 elements must be ✅ before drafting.
---
## Problem Statement Table
| Element | Definition | Evidence |
|---------|------------|----------|
| **Who is hurting?** | [Specific persona: role + business type + size] | [Segment size or example] |
| **What pain exists today?** | [Observable behavior or workflow friction] | [CFD-###] |
| **Cost of problem** | [Time: X hrs/week OR Money: $X/month OR Risk: $X per incident] | [Calculation source] |
| **Why now?** | [Market trigger: regulation, technology, competitor move] | [Trend or event] |
| **What's impossible?** | [What they can't do today that they want to] | [User statement] |
---
## CFD Entry Template
```markdown
## CFD-###: [Short Title]
**Date:** YYYY-MM-DD
**Source:** [Platform / Person / Method]
**Evidence Tier:** [1-5]
**Confidence:** [High / Medium / Low]
### Verbatim Quote
> "[Exact words from source]"
### Pain Dimensions Extracted
1. [Dimension 1]: [Brief description]
2. [Dimension 2]: [Brief description]
3. [Dimension 3]: [Brief description]
### Cost Signals
- Time: [If mentioned]
- Money: [If mentioned]
- Risk: [If mentioned]
### Implications
- [How this affects problem statement]
```
---
## Evidence Tier Reference
| Tier | Type | Examples | Use |
|------|------|----------|-----|
| 1 | Buying behavior | Invoices, subscriptions, job budgets | ✅ Strong |
| 2 | Active workarounds | Spreadsheets, hired help, manual processes | ✅ Strong |
| 3 | Complaints with cost | "Costs me X hours", "Paying $Y" | ✅ Acceptable |
| 4 | General complaints | "This is annoying" | ⚠️ Weak |
| 5 | Speculation | "Users might want..." | ❌ Reject |
---
## Quality Gate Checklist
Before advancing to v0.2:
- [ ] At least 1 Tier 1-2 evidence item exists
- [ ] Cost is quantified (time, money, or risk)
- [ ] "Who" is specific enough to create a prospect list
- [ ] "Why now" has at least a Tier 3 hypothesis
- [ ] Can find 10 people with this problem in 48 hours
- [ ] Can observe the pain behavior (not just hear about it)
---
## Spark Summary Template
```markdown
### Spark Summary
[One-sentence problem statement]: [Who] faces [pain] costing [quantified amount] because [root cause]. [Why now trigger] creates urgency. Current solutions [gap or failure]. [CFD-###]
```
**Example**:
> SMBs with 1-10 display screens face a "sneakernet" problem costing 15-30 min per update because existing digital signage solutions price for enterprise scale. Streaming device ubiquity ($30 Fire TV) creates urgency. Current solutions require 100+ screen minimums or complex setup. [CFD-001]
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |