PRD — 製品要件ドキュメント

製品ビジョンと調査を明確で実行可能なエンジニアリング仕様に変換します。8つのセクション構造に従う PRD-[product-name].md 出力ファイルを作成します。

出力ファイル名: PRD-[product-name].md (例: PRD-sso-invite-flow.md)

引数の解決

PRODUCT = "$ARGUMENTS"  # Product name or feature, e.g., "SSO invite flow"

ステップ 0: スコープの明確化

AskUserQuestion(
  questions=[{
    "question": "What type of PRD?",
    "header": "PRD Scope",
    "options": [
      {"label": "Full PRD (Recommended)", "description": "All 8 sections with research, stories, and release plan", "markdown": "```\nFull PRD (8 sections)\n─────────────────────\n1. Executive Summary\n2. Problem Statement\n3. Objectives & KPIs\n4. User Stories (INVEST)\n5. Functional Requirements\n6. Non-Functional Requirements\n7. Release Plan\n8. Appendices\n```"},
      {"label": "Lightweight spec", "description": "Summary, objectives, user stories only", "markdown": "```\nLightweight Spec\n────────────────\n1. Summary (1 paragraph)\n2. Objectives (3-5 bullets)\n3. User Stories\n\nBest for: internal tools,\nsmall features, quick specs\n```"},
      {"label": "User stories only", "description": "INVEST stories with acceptance criteria", "markdown": "```\nUser Stories Only\n─────────────────\nAs a [role], I want [goal]\nso that [benefit].\n\nAcceptance Criteria:\nGiven... When... Then...\n\nINVEST: Independent,\nNegotiable, Valuable,\nEstimable, Small, Testable\n```"},
      {"label": "Update existing PRD", "description": "I have a PRD file to iterate on", "markdown": "```\nUpdate Existing PRD\n───────────────────\n→ Read current PRD file\n→ Identify gaps/changes\n→ Preserve approved sections\n→ Track change history\n```"}
    ],
    "multiSelect": false
  }]
)

タスク管理

# 1. メインタスクを即座に作成
TaskCreate(subject="Write PRD: {PRODUCT}", description="8-section PRD with user stories and acceptance criteria", activeForm="Writing PRD for {PRODUCT}")

# 2. 各フェーズのサブタスクを作成
TaskCreate(subject="Scope clarification", activeForm="Clarifying PRD scope")                       # id=2
TaskCreate(subject="Research and memory check", activeForm="Researching prior PRDs")               # id=3
TaskCreate(subject="Draft 8-section PRD", activeForm="Drafting PRD sections")                      # id=4
TaskCreate(subject="Write user stories and acceptance criteria", activeForm="Writing user stories") # id=5
TaskCreate(subject="Write output file", activeForm="Writing PRD file")                             # id=6

# 3. 順序フェーズの依存関係を設定
TaskUpdate(taskId="3", addBlockedBy=["2"])  # Research needs scope first
TaskUpdate(taskId="4", addBlockedBy=["3"])  # Drafting needs research context
TaskUpdate(taskId="5", addBlockedBy=["4"])  # Stories need draft structure
TaskUpdate(taskId="6", addBlockedBy=["5"])  # Output needs all sections done

# 4. 各タスク開始前にブロック解除を確認
task = TaskGet(taskId="2")  # Verify blockedBy is empty

# 5. 進捗に合わせてステータスを更新
TaskUpdate(taskId="2", status="in_progress")  # When starting
TaskUpdate(taskId="2", status="completed")    # When done — repeat for each subtask

メモリの統合

# 以前のPRDと製品決定を検索
mcp__memory__search_nodes(query="{PRODUCT} PRD requirements")

# PRDが書かれた後、重要な決定を保存
mcp__memory__create_entities(entities=[{
  "name": "PRD-{product-slug}",
  "entityType": "document",
  "observations": ["PRD written for {PRODUCT}", "Key objectives: ..."]
}])

8セクションPRDテンプレート

Read("${CLAUDE_SKILL_DIR}/references/prd-template.md") を読み込んで、すべての8つのセクション(サマリー、連絡先、背景、目的、市場セグメント、価値提案、ソリューション、リリース)、優先度レベル、およびNFRカテゴリーを含む完全なテンプレートを取得します。

ユーザーストーリーと受け入れ基準

Read("${CLAUDE_SKILL_DIR}/references/user-stories-guide.md") を読み込んで、INVEST基準、ストーリーフォーマット、Gherkin受け入れ基準、および準備完了/完了の定義を確認します。

価値提案キャンバス

Read("${CLAUDE_SKILL_DIR}/references/value-prop-canvas-guide.md") を読み込んでキャンバステンプレートとフィットチェックプロセスを確認します。すべての価値マップ項目は、Job、Pain、またはGainに対応する必要があります。

Go/No-Goゲート基準

ルールから読み込みます: Read("${CLAUDE_SKILL_DIR}/rules/strategy-go-no-go.md") でステージゲート基準とスコアリング閾値を確認します(Go >= 7.0 | 条件付き 5.0-6.9 | No-Go < 5.0)。

ルール(必要に応じて読み込み)

research-requirements-prd.md — INVESTユーザーストーリー、PRDテンプレート、優先度レベル、DoR/DoD
strategy-value-prop.md — 価値提案キャンバス、JTBDフレームワーク、フィット評価
strategy-go-no-go.md — ステージゲート基準、スコアリング、ビルド/バイ/パートナー決定マトリックス

参考資料

output-templates.md — PRD、ビジネスケース、戦略成果物の構造化JSON出力スキーマ
value-prop-canvas-guide.md — 詳細な価値提案キャンバスファシリテーションガイド

出力

PRD生成後、ディスクに書き込みます:

Write(f"PRD-{product_slug}.md", prd_content)
TaskUpdate(status="completed")

プランモードのファイル名(CC 2.1.111+): このスキルがPRDを書き込む前にプランモード(EnterPlanMode経由)に入った場合、CC 2.1.111はランダムな単語ではなくプロンプトステムの後に結果のプランファイルに名前を付けます。クリーンなファイル名を取得するには、プランモードプロンプトに製品スラッグを含めます(例: EnterPlanMode("PRD: authentication-rework") → plans/prd-authentication-rework.md)。2.1.111より前のバージョンでは、プランファイル名は plans/swift-cobra.md などでした — 必要に応じて確認して名前を変更してください。

チェーン: 次のステップ

PRDが承認された後、実装にチェーンします:

/ork:implement PRD-{product-slug}.md

write-prd

SKILL.md 本文