本文へ移動
cccskills
無料GitHub で公開

prd-v01-user-value-articulation

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.

インストール方法を見る

含まれるファイル(4)

  • SKILL.md6.2 KB
  • assets/value-statement.md2.4 KB
  • references/research-prompts.md3.4 KB
  • references/transformation-examples.md4.1 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

User Value Articulation Skill

Transform validated pain points into evidence-anchored value statements.

Workflow Position

Problem Framing → User Value Articulation → v0.2 Market Definition
     (pain)              (value)                  (who cares most)

Consumes

This skill requires prior work from v0.1:

  • **CFD-* entries (pain points, from Problem Framing) — Evidence for what problems users face
  • PRD.md Why section (problem statement table) — Context for pain-to-value transformation

This skill assumes v0.1 Problem Framing is complete.

Produces

This skill creates/updates:

  • CFD-* entries (tagged as value hypotheses) — Transformation of pain points into value statements, with confidence scoring
  • MVP scope signal — Identifies which value dimensions will drive MVP feature scope (handed to v0.3)

All CFD value hypothesis entries should include:

  • confidence: 2-3/5 (based on evidence tier from users or market)
  • Evidence tier (1-5 per value hierarchy)
  • Forward target: "Would move to 4/5 if we validate with beta cohort"

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"

Workflow Overview

  1. Receive pain points → Read CFD-IDs from Problem Framing
  2. Identify value unit → Time / Money / Risk / Capability
  3. Transform pain → value → Apply transformation pattern
  4. Anchor to evidence → What proof users want this outcome?
  5. Create CFD entry → Tag as value hypothesis with tier

Core Output Template

ElementDefinition
Pain (source)CFD-ID from Problem Framing
Value StatementOne sentence: what user gains
Value UnitTime / Money / Risk / Capability
QuantificationNumber with unit
Framing TypeNegative Removal / Positive Gain / Capability Unlock / Risk Reduction
Evidence Tier1-5 per hierarchy
Supporting CFDNew CFD-ID for value hypothesis

See assets/value-statement.md for copy-paste template.

Pain → Value Transformation

Pain PatternValue 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"

Framing Type Selection

TypeWhen to Use
Negative RemovalPain is acute, quantified loss; "hate", "wasting", "losing"
Positive GainOpportunity cost clear; "I wish I could..."
Capability UnlockSomething impossible, not just hard; "We can't..."
Risk ReductionRegulatory/compliance; penalty amounts cited

Value Evidence Tier Hierarchy

TierDescriptionWeight
1User already paying for this value elsewhere✅ Highest
2User actively trying to achieve this outcome✅ Strong
3User articulates wanting this (unprompted)✅ Acceptable
4User agrees when prompted⚠️ Weak
5Builder assumes value❌ Reject

Gate rule: ≥1 value statement must have Tier 1-3 evidence before v0.2.

CFD Entry Format

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.

Quality Gates

Pass Checklist

  • Every pain point has corresponding value statement
  • ≥1 value statement has Tier 1-3 evidence
  • All values quantified (time, money, risk, capability)
  • No feature-as-value statements
  • Value unit matches pain unit

Testability Check

  • Can explain value in <10 seconds to prospect?
  • Can test with landing page headline?
  • Value statement contains no features (no "dashboard", "tool")?

Anti-Patterns

PatternSignalFix
Feature as value"Dashboard", "tool", "feature" in statementRewrite as outcome
Unmeasurable"Better", "improved" without numberAdd quantity
DisconnectedPain unit ≠ value unitMatch units
Round inflation"Save 10 hours" no sourceRequire calculation
No evidenceNo CFD-ID for user desireDowngrade tier
Solution creepHOW (feature) not WHAT (outcome)Remove implementation

Bundled Resources

  • 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.

Handoff

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?)

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

Validates gate criteria before PRD lifecycle advancement by delegating to the readiness scoring pipeline (scripts/readiness.py). Returns a graduated PASS / WARN / BLOCK verdict with top blockers and their causal chain. Triggers before advancing from v0.X to v0.Y or explicit `/ghm-gate-check`.

日本語の概要は準備中です。原文の説明を表示しています。

mattgierhart/PRD-driven-context-engineering1812026年8月31日 更新

Extracts durable insights from temp/ files to SoT during EPIC Phase E. Triggers at EPIC completion or explicit `/ghm-harvest` invocation. Outputs new SoT entries and archive manifest.

日本語の概要は準備中です。原文の説明を表示しています。

mattgierhart/PRD-driven-context-engineering1812026年8月31日 更新

Validates and registers new SoT IDs with cross-reference integrity. Triggers when creating BR-XXX, UJ-XXX, API-XXX, or CFD-XXX entries. Outputs formatted SoT entry with validated cross-references.

日本語の概要は準備中です。原文の説明を表示しています。

mattgierhart/PRD-driven-context-engineering1812026年8月31日 更新

Install the PRD-Driven Context Engineering methodology into a fresh OR existing repository — the subscription-native alternative to forking the whole repo. Runs an interactive wizard that seeds the framework (.claude/ hooks, skills, agents, rules, scripts) without clobbering product content. Triggers on "install the methodology", "adopt this into my repo", "self-install", "set up PRD lifecycle here", "onboard existing project". Outputs an installed framework + a verification report.

日本語の概要は準備中です。原文の説明を表示しています。

mattgierhart/PRD-driven-context-engineering1812026年8月31日 更新

Creates new Source of Truth (SoT) files when existing templates don't fit your needs. Triggers on requests to create a new SoT file, add a new artifact type, or when user says "I need to track [X] but there's no SoT for it", "create SoT", "new source of truth". Outputs a properly structured SoT.*.md file with ID prefix, frontmatter, and update protocol.

日本語の概要は準備中です。原文の説明を表示しています。

mattgierhart/PRD-driven-context-engineering1812026年8月31日 更新

Synchronizes README.md Command Center with current project state. Triggers on gate changes, EPIC status changes, or explicit `/ghm-status-sync` invocation. Outputs updated README.md dashboard with current lifecycle stage, blockers, and metrics.

日本語の概要は準備中です。原文の説明を表示しています。

mattgierhart/PRD-driven-context-engineering1812026年8月31日 更新

mattgierhart のスキルをすべて見る

このスキルの問題を報告する