write-prd

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"},
      {"label": "Lightweight spec", "description": "Summary, objectives, user stories only"},
      {"label": "User stories only", "description": "INVEST stories with acceptance criteria"},
      {"label": "Update existing PRD", "description": "I have a PRD file to iterate on"}
    ],
    "multiSelect": false
  }]
)

タスク管理

# 1. Create main task IMMEDIATELY
TaskCreate(subject="Write PRD: {PRODUCT}", description="8-section PRD with user stories and acceptance criteria", activeForm="Writing PRD for {PRODUCT}")

# 2. Create subtasks for each phase
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. Set dependencies for sequential phases
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. Update status as you progress
TaskUpdate(taskId="2", status="in_progress")  # When starting
TaskUpdate(taskId="2", status="completed")    # When done — repeat for each subtask

メモリ統合

# Search for prior PRDs and product decisions
mcp__memory__search_nodes(query="{PRODUCT} PRD requirements")

# After PRD is written, store key decisions
mcp__memory__create_entities(entities=[{
  "name": "PRD-{product-slug}",
  "entityType": "document",
  "observations": ["PRD written for {PRODUCT}", "Key objectives: ..."]
}])

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

すべての 8 セクション（Summary、Contacts、Background、Objective、Market Segments、Value Propositions、Solution、Release）、優先度レベル、NFR カテゴリを含む完全なテンプレートは、Read("references/prd-template.md") を読み込んでください。

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

INVEST 基準、ストーリー形式、Gherkin 受け入れ基準、Definition of Ready/Done については、Read("references/user-stories-guide.md") を読み込んでください。

価値提案キャンバス

キャンバステンプレートと適合性確認プロセスについては、Read("references/value-prop-canvas-guide.md") を読み込んでください。Value Map のすべての項目は、Job、Pain、または Gain に対応している必要があります。

Go/No-Go ゲート基準

ステージゲート基準とスコアのしきい値（Go >= 7.0 | Conditional 5.0-6.9 | No-Go < 5.0）については、ルールから Read("rules/strategy-go-no-go.md") を読み込んでください。

ルール（必要に応じて読み込み）

• 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 の承認後、受け入れ基準を実行可能なゴールに分解し、実装します。

prd-to-goal PRD-{product-slug}.md   # → one copy-pasteable `/goal until …, or stop after N turns` line
implement PRD-{product-slug}.md

prd-to-goal は、以下の Go/No-Go ゲートと受け入れ基準を 1 つの AND 結合されたブール値アサーションにまとめます。これにより、PRD を手動で読み通すのではなく、自律的な /goal 実行の起点にできます。

関連スキル

• ork:user-research — PRD を作成する前に、ユーザーへの理解を深めます（ペルソナ、ジャーニーマップ、インタビュー）
• ork:prd-to-goal — この PRD の受け入れ基準を、1 行の /goal until …, or stop after N turns にまとめます
• ork:implement — PRD に基づく実装計画を実行します
• ork:brainstorm — PRD のスコープを確定する前に、ソリューションの代替案を検討します
• ork:assess — PRD の品質と完全性を評価します

---

バージョン： 2.0.0