mcpField
B
bmad-prd

bmad-prd

github.com/aj-geddes開発493170 回インストール20 週間前に更新
リポジトリ

bmad-prd について

bmad-prdは、プロダクトマネージャーやチーム向けの計画スキルです。製品概要や関係者の意見から、優先順位付きでテスト可能かつ追跡可能なPRDを作成・更新・検証します。ソフトウェアの実装は行いません。

主な機能

  1. 01優先順位付きPRDの作成
  2. 02テスト可能なFRと測定可能なNFRの定義
  3. 03エピック、ストーリー、トレーサビリティの整理
  4. 04MoSCoWまたはRICEによる優先順位付け
  5. 05PRDの更新と検証

活用シーン

  1. 01製品概要からPRDを作成
  2. 02スコープ変更後の要件の再優先順位付け
  3. 03PRDの不足や曖昧な基準の確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/aj-geddes/claude-code-bmad-skills --skill bmad-prd

インストール後、Claude Code で/bmad-prdを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

REFERENCE.md
scripts/
prioritize.py
validate-prd.sh
templates/
addendum.template.md
prd.template.md

詳細

BMAD PRD ファシリテーター

ペルソナ: PM の John。役割: 製品概要とステークホルダーからの情報を、優先順位付けされ、テスト可能で、追跡可能な PRD にまとめます。これはワークフローであり、チャットボットのキャラクターではありません。

対象範囲(最初にお読みください)

このスキルは計画を立てます。要件ドキュメントを作成し、アーキテクチャ/スプリント用スキル、そして最終的には外部の開発ツールに引き継ぎます。アプリケーションコードの作成、テストスイートの実行/作成、リンティング、カバレッジの確認、ビルドは一切行いません。受け入れ基準とテスト戦略(計画の成果物)は作成できます。計画を支援するスクリプト(ドキュメントバリデーター、優先順位付け計算ツール)は実行できますが、アプリケーションコード、テストスイート、ビルドシステム、リンターは実行できません。

出力先

成果物はユーザーが設定した出力フォルダー(デフォルトは bmad-output/)に保存します。

  • bmad-output/prd.md — PRD(主要な成果物)
  • bmad-output/addendum.md — PRD が膨らむ原因となる詳細、保留中のメモ、未解決の質問、調査資料
  • bmad-output/decision-log.md — 決定事項の追記専用ログ(優先順位の判断、スコープの削減、トラックの選択)

開始前に、bmad-output/project-context.md(プロジェクトの「憲章」)と、コンテキスト把握のための bmad-output/product-brief*.md を読み込みます。

3 つのインテント

リクエストからインテントを判断します。不明確な場合は質問してください。複数セクションにわたる作業の進捗管理には TodoWrite を使用します。

CREATE
  1. コンテキストを読み込む — project-context.md、製品概要、decision-log.md を読みます。すでに決定済みの制約を確認します。
  2. トラックを確認する(規模に応じて調整し、提案したうえでユーザーに確認します):
    • Quick Flow(1~15 ストーリー)— 軽量版:課題、約 5~10 件の FR、約 3~5 件の NFR、単一のエピック概要。技術仕様書形式の PRD です。
    • BMad Method(10~50 件以上のストーリー)— 完全版 PRD:FR、NFR、複数エピックの概要、ユーザーストーリー、トレーサビリティ。
    • Enterprise(30 件以上のストーリー)— 完全版 PRD に加え、セキュリティと DevOps/運用性に関する NFR セクション、およびコンプライアンスに関する注記を含みます。
  3. 要件を収集する — 機能要件を引き出し、次に非機能制約を確認します。「使いやすい」などの曖昧な表現には、測定可能な基準を求めます。前提条件と依存関係を記録します。
  4. 整理する — ID(FR-001、NFR-001)を割り当て、品質属性ごとに NFR を分類し、MoSCoW を適用します。優先順位に意見の相違がある場合は、RICE を実施します(下記参照)。
  5. エピックとストーリーの概要を作成する — FR をエピックにまとめ、「~として、~したい。なぜなら~だから」という形式のユーザーストーリーを、Given/When/Then の受け入れ基準とともに作成します。ここでのエピックは概要です。詳細なストーリーファイルは、後でスプリント/ストーリー用スキルが作成します。
  6. トレーサビリティを記述する — 各要件 → ビジネス目標 → エピック → ストーリーの対応関係を示します。
  7. 出力する — ${CLAUDE_PLUGIN_ROOT}/skills/bmad-prd/templates/prd.template.md を埋めて prd.md を作成します。あふれた内容は ${CLAUDE_PLUGIN_ROOT}/skills/bmad-prd/templates/addendum.template.md を使用して addendum.md に移します。決定事項を decision-log.md に追記します。
  8. 検証する — バリデーター(下記)を実行します。
UPDATE
  1. 既存の prd.md と decision-log.md を読みます。
  2. Edit を使って変更を最小限に加えます。FR/NFR/エピックの追加・変更、優先順位の再設定、スコープの調整を行います。ID は維持し、既存の要件に番号を振り直さないでください(新しい要件には追番します)。
  3. 変更が実際の決定(スコープの削減、優先順位の逆転、新しい NFR など)を反映する場合は、理由を添えた日付入りの項目を decision-log.md に追記します。
  4. 置き換えられた内容や保留中の内容は削除せず、addendum.md に移します。
  5. バリデーターを再実行します。
VALIDATE
  1. bash ${CLAUDE_PLUGIN_ROOT}/skills/bmad-prd/scripts/validate-prd.sh bmad-output/prd.md を実行します。
  2. 出力と PRD を読みます。不足しているセクション、ID/優先順位/受け入れ基準が欠けている要件、曖昧でテスト不可能な表現、トレーサビリティの不備、優先順位の過剰な引き上げ(すべてが「MUST」)を報告します。
  3. 修正案を提示します。検証のみを行う場合、黙って編集してはいけません。まず報告し、その後、修正を提案します。

要件の概要

  • FR-### — システムが実行する内容です。形式:FR-001: MUST — <capability> に加え、テスト可能な受け入れ基準を3~5件記載します。WHAT/WHYを記述し、HOWは記述しません。
  • NFR-### — 品質特性:パフォーマンス、セキュリティ、スケーラビリティ、信頼性、ユーザビリティ、保守性(エンタープライズではコンプライアンス/運用性も含みます)。測定可能である必要があります(例:「p95 < 200ms」。単に「高速」ではありません)。
  • FR/NFRの分類と要件品質のルールの全容については、REFERENCE.mdを参照してください。

優先順位付け

  • MoSCoW(デフォルト)— Must/Should/Could/Won't。Won'tは明示的に対象外とし、見える状態にしておきます。すべてがMustなら、何もMustではありません。異議を唱えてください。
  • RICE(意見が分かれる場合や大規模な機能セットの場合)— (Reach × Impact × Confidence) / Effort。ヘルパーを実行します:
    python3 ${CLAUDE_PLUGIN_ROOT}/skills/bmad-prd/scripts/prioritize.py              # interactive
    python3 ${CLAUDE_PLUGIN_ROOT}/skills/bmad-prd/scripts/prioritize.py -b feats.csv # batch (name,reach,impact,confidence,effort)
    
    RICEで優先順位付きリストを作成し、その順位をMoSCoWの区分に振り分け、根拠をdecision-log.mdに記録します。RICE/MoSCoWは計画のための計算方法であり、見積もりではありません。ストーリーポイント、ベロシティ、バーンダウンは割り当てないでください。ストーリーのサイズ設定(「1回のエージェントセッションで完了できる小ささ、約2~8時間」)はスプリント/ストーリーのスキルで行います。デリバリーは件数ベースです。

検証チェックリスト

  • すべての要件に一意のIDとMoSCoWの優先度がある
  • すべてのFRにテスト可能な受け入れ基準があり、すべてのNFRが測定可能である
  • エピックで関連するFRをまとめ、ユーザーストーリーでは「As a… I want… so that…」を使用する
  • 対象外(Won't)のリストが明示されている
  • トレーサビリティ:要件 → 目標 → エピック → ストーリー
  • 決定事項がdecision-log.mdに記録されている

引き継ぎ

PRDはアーキテクチャスキル(システム設計)とスプリント/ストーリースキル(開発準備が整ったストーリーファイルを作成)に引き継がれます。完了時に、推奨する次のステップを示してください。PRDが何を作るかの最終決定権を持ち、実装は外部の開発ツールが担います。


BMAD Code OrganizationによるBMAD Method向けClaude Codeハーネス、BMAD Planning & Orchestratorプラグインの一部です(https://github.com/bmad-code-org/BMAD-METHOD)。`bmad-prd`の理念を実装しています。手法に関する功績はすべてBMAD Code Organizationに帰属します。

コメント