.claude/skills/prd-v01-user-value-articulation/SKILL.md
Transform validated pain points into articulated user value statements for PRD v0.1 Spark. Triggers on completing problem framing, defining user outcomes, articulating value propositions, or requests like "what value do users get", "define outcomes", "articulate the benefit", "finish v0.1", "pain to value", "what do they gain". Outputs CFD- entries tagged as value hypotheses with evidence tiers. Follows Problem Framing skill in workflow.
npx skillsauth add mattgierhart/PRD-driven-context-engineering prd-v01-user-value-articulationInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Transform validated pain points into evidence-anchored value statements.
Problem Framing → User Value Articulation → v0.2 Market Definition
(pain) (value) (who cares most)
This skill requires prior work from v0.1:
This skill assumes v0.1 Problem Framing is complete.
This skill creates/updates:
All CFD value hypothesis entries should include:
confidence: 2-3/5 (based on evidence tier from users or market)Example value hypothesis entry:
CFD-015: Value Hypothesis — Eliminate manual reconciliation workflow
Source Pain: CFD-001 (sales teams waste 5+ hours/week)
Evidence Tier: 2-3 (workaround + quantified cost)
Confidence: 3/5 (source: 3-customer-interviews-jan-2026)
Value Statement: "Reclaim 5 hours/week for strategic pipeline management"
Transformation: [5 hours wasted] → [5 hours available for growth]
Framing Type: Negative Removal (acute quantified loss)
Quantification: 5 hours/week = ~250 hours/year = $12,500 (at $50/hr)
Next Target: "Would move to 4/5 if we observe beta cohort using this feature"
| Element | Definition | |---------|------------| | Pain (source) | CFD-ID from Problem Framing | | Value Statement | One sentence: what user gains | | Value Unit | Time / Money / Risk / Capability | | Quantification | Number with unit | | Framing Type | Negative Removal / Positive Gain / Capability Unlock / Risk Reduction | | Evidence Tier | 1-5 per hierarchy | | Supporting CFD | New CFD-ID for value hypothesis |
See assets/value-statement.md for copy-paste template.
| Pain Pattern | Value Pattern | |--------------|---------------| | "Costs X time" | "Reclaim X time for [higher-value work]" | | "Costs $X" | "Save $X [or redirect to growth]" | | "Risks $X penalty" | "Eliminate $X exposure" | | "Cannot do X" | "Now able to X when [trigger]" | | "Takes X steps" | "Complete in Y steps" | | "Manual process" | "Automatic + verifiable" |
| Type | When to Use | |------|-------------| | Negative Removal | Pain is acute, quantified loss; "hate", "wasting", "losing" | | Positive Gain | Opportunity cost clear; "I wish I could..." | | Capability Unlock | Something impossible, not just hard; "We can't..." | | Risk Reduction | Regulatory/compliance; penalty amounts cited |
| Tier | Description | Weight | |------|-------------|--------| | 1 | User already paying for this value elsewhere | ✅ Highest | | 2 | User actively trying to achieve this outcome | ✅ Strong | | 3 | User articulates wanting this (unprompted) | ✅ Acceptable | | 4 | User agrees when prompted | ⚠️ Weak | | 5 | Builder assumes value | ❌ Reject |
Gate rule: ≥1 value statement must have Tier 1-3 evidence before v0.2.
CFD-###: Value Hypothesis — [Title]
Type: Value Hypothesis
Source Pain: CFD-###
Evidence Tier: [1-5]
Value Statement: "[User gains X measured in Y]"
Transformation: [Pain] → [Value]
Framing Type: [Type]
Quantification: [Number with unit]
See references/transformation-examples.md for worked examples.
| Pattern | Signal | Fix | |---------|--------|-----| | Feature as value | "Dashboard", "tool", "feature" in statement | Rewrite as outcome | | Unmeasurable | "Better", "improved" without number | Add quantity | | Disconnected | Pain unit ≠ value unit | Match units | | Round inflation | "Save 10 hours" no source | Require calculation | | No evidence | No CFD-ID for user desire | Downgrade tier | | Solution creep | HOW (feature) not WHAT (outcome) | Remove implementation |
references/transformation-examples.md — 3 worked examples from real PRDs with step-by-step transformation process.references/research-prompts.md — Deep research templates when value evidence is Tier 4-5.assets/value-statement.md — Copy-paste template for value tables and CFD entries.Value articulation complete when quality gates pass. Combined with Problem Framing, v0.1 Spark is ready.
Next: v0.2 Market Definition (Who cares MOST about this value? Who pays FIRST?)
tools
Make technology decisions for every product capability by discovering existing assets, evaluating vendor-aligned options, and categorizing as Reuse/Extend/Build/Buy/Integrate/Research during PRD v0.5 Red Team Review. Handles both greenfield and brownfield contexts. Triggers on "tech stack", "build or buy?", "what technologies?", "technical decisions", "what do we reuse?", "existing stack", "vendor constraint", "IBM-first", "what tools do we need?", "evaluate solutions", "select tech stack". Consumes FEA- (features), SCR- (screens), RISK- (constraints). Outputs TECH- entries with decisions, rationale, and cross-references. Feeds v0.6 Architecture Design.
development
Define success criteria and tracking setup for launch during PRD v0.9 Go-to-Market. Triggers on requests to define launch metrics, set up tracking, or when user asks "how do we measure launch success?", "launch KPIs", "tracking setup", "success criteria", "analytics", "launch goals". Outputs KPI- entries specialized for launch measurement.
development
Define go-to-market strategy including launch plan, messaging, channels, and timing during PRD v0.9 Go-to-Market. Triggers on requests to plan launch, define GTM strategy, or when user asks "how do we launch?", "go-to-market", "launch plan", "marketing strategy", "messaging", "launch channels", "GTM". Outputs GTM- entries with launch plan components.
development
Establish channels and processes for capturing and processing post-launch feedback during PRD v0.9 Go-to-Market. Triggers on requests to set up feedback systems, capture user input, or when user asks "how do we collect feedback?", "feedback loop", "user research", "post-launch feedback", "customer feedback", "NPS", "voice of customer". Outputs CFD- entries specialized for post-launch feedback capture.