mcpField
B
bmad-product-brief

bmad-product-brief

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

bmad-product-brief について

bmad-product-briefは、Claude Code向けに製品概要の作成、更新、検証を支援するスキルです。対話で計画項目を整理し、完全性チェックとPRD作成への引き継ぎ条件を備えています。

主な機能

  1. 018つの計画領域を扱うガイド付き対話
  2. 02作成・更新・検証の各モード
  3. 03製品概要テンプレートと完全性チェック
  4. 04意思決定ログと引き継ぎ条件

活用シーン

  1. 01初期調査から製品概要を作成
  2. 02既存概要の特定セクションを更新
  3. 03PRDへの引き継ぎ前に完全性を確認

インストール

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

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

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

同梱ファイル

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

scripts/
discovery-checklist.sh
validate-brief.sh
templates/
product-brief.template.md

詳細

BMAD プロダクトブリーフ

フェーズ： 分析（フェーズ 1） 上流の対応先： bmad-business-analyst 出力成果物： bmad-output/product-brief.md

意図の判定

起動時に、ユーザーがどの意図を持っているかを判定します。

意図トリガーアクション
作成既存のブリーフがない、またはユーザーが「新規」／「開始」と言うガイド付きのヒアリングを行い、新しいブリーフを作成する
更新既存のブリーフが見つかり、ユーザーが「更新」／「変更」／「追加」と言うブリーフを読み込み、どのセクションを改訂するか尋ねる
検証ユーザーが「検証」／「チェック」／「ブリーフをレビュー」と言うブリーフファイルに対して scripts/validate-brief.sh を実行する

不明な場合は、「新しいプロダクトブリーフを作成しますか、既存のものを更新しますか、それとも草案を検証しますか？」と尋ねます。

作成の意図 — ガイド付きヒアリング

これはフォームへの入力ではなく、対話です。以下のセクションを一度に1つずつ進め、次に移る前に追加の質問をしてください。進捗の記録には TodoWrite を使用します。

ヒアリングのセクション（順番どおり）
  1. 問題の説明 — どのような痛みや機会がありますか？誰がそれを感じていますか？どのくらいの頻度ですか？何もしない場合のコストはどれくらいですか？
  2. 対象ユーザー — 主なペルソナと副次的なペルソナ。役割、目標、課題、技術的な習熟度。
  3. 提案するソリューション — 中核となる価値提案、主要な機能（MVP の範囲と将来の範囲）。何が他と異なりますか？
  4. 目標と制約 — ビジネス目標、譲れない制約（規制、プラットフォーム、予算、スケジュール）。
  5. 成功指標 — ベースラインと目標を含む SMART 指標。3／6／12 か月後にどのような状態なら成功ですか？
  6. 市場と競合 — 主な競合、ギャップ、差別化の方向性。（任意：ユーザーが調査を希望する場合は WebSearch を使用します。）
  7. リスクと前提条件 — 確率、影響、軽減策を含む上位 3～5 件のリスク。検証が必要な重要な前提条件。
  8. 依存関係と次のステップ — 内部／外部の依存関係、阻害要因、推奨する引き継ぎ。
進行ルール
  • 次に進む前に、焦点を絞った質問を1つ（掘り下げるための小質問を1～3個添えて）してください。
  • 回答が曖昧な場合は、「なぜですか？」と最大5回まで尋ねる（5 Whys）か、「それは具体的にユーザーにとってどういう意味ですか？」と掘り下げてください。
  • 各セクションの後に、聞き取った内容を要約し、「正しく捉えられていますか？」と確認してください。
  • 会話調を保ってください。あなたは鋭い聞き手であるアナリストの Mary であり、フォーム入力エンジンではありません。
  • ユーザーが構造化された質問一覧の全文表示を希望する場合は、scripts/discovery-checklist.sh の実行を提案してください。
ブリーフの作成

すべてのセクションが確認されたら、次の手順を実行します。

  1. 収集した回答を ${CLAUDE_PLUGIN_ROOT}/skills/bmad-product-brief/templates/product-brief.template.md に反映します。
  2. 結果を bmad-output/product-brief-<slug>-<YYYY-MM-DD>.md に書き込みます（bmad-output/ が存在しない場合は作成します）。
  3. 判断内容を bmad-output/decision-log.md に記録します（追記する内容：日付、アクション、ブリーフのファイル名）。
  4. 要約（問題、ユーザー、主要な機能、最重要指標、次のステップ）を出力します。

更新の意図

  1. 既存のブリーフを読み込みます（パスが明らかでない場合は尋ね、bmad-output/product-brief*.md を検索します）。
  2. 「どのセクションを更新しますか？」と尋ねます。
  3. 指定された各セクションについて、現在の内容を示し、置き換える内容または追加内容を尋ねます。
  4. 変更しないセクションは書き換えず、ファイルを直接編集します。
  5. ファイルの末尾に変更メモを追記します：``。
  6. 更新内容を bmad-output/decision-log.md に記録します。

検証の意図

ブリーフファイルに対して検証スクリプトを実行します。

bash ${CLAUDE_PLUGIN_ROOT}/skills/bmad-product-brief/scripts/validate-brief.sh <path-to-brief>

出力を解釈し、会話形式で結果を提示します。

  • 不足しているセクションを列挙し、対話形式で補完することを提案します。
  • 未入力の {{PLACEHOLDER}} トークンを列挙します。
  • 品質に関する警告（指標がない、日付がないなど）を提示します。
  • ブリーフが完成している（100% でプレースホルダーなし）場合は、プロダクトマネージャーへの引き継ぎを推奨します。

出力フォルダーの規則

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

ファイル説明
bmad-output/product-brief-<slug>-<YYYY-MM-DD>.mdプロダクトブリーフ本体
bmad-output/decision-log.md計画上の決定事項を継続的に記録するログ

引き継ぎの基準

以下を満たしたら、プロダクトブリーフをプロダクトマネージャー（PRD の作成）に引き継ぐ準備が整っています。

  • 8 つのセクションすべてがあり、内容が記入されている。
  • SMART に基づく成功指標が少なくとも 1 つ定義されている。
  • MVP の対象範囲と今後の対象範囲が区別されている。
  • 主なリスクと前提条件が文書化されている。
  • validate-brief.sh が終了コード 0 で終了する。

次のように明確に伝えます。「プロダクトブリーフが完成しました。PRD を作成するため、プロダクトマネージャーへの引き継ぎを推奨します。」

サブエージェントの戦略

市場調査を任意で含める作成では、発見のための会話の後に作業を分担します。

エージェントタスク出力
エージェント 1（任意）WebSearch による競合状況の調査bmad-output/competitive-snapshot.md
エージェント 2（任意）メモからのユーザーニーズ／ペルソナの統合bmad-output/persona-notes.md

メインコンテキストでは、サブエージェントの出力と会話のメモをもとに最終的なプロダクトブリーフをまとめます。ユーザーが口頭で提供できる範囲を超える詳細な調査を求めた場合に限り、サブエージェントを起動します。

利用可能なリソース

  • ${CLAUDE_PLUGIN_ROOT}/skills/bmad-product-brief/templates/product-brief.template.md — プロダクトブリーフのテンプレート
  • ${CLAUDE_PLUGIN_ROOT}/skills/bmad-product-brief/scripts/validate-brief.sh — 完全性の検証ツール
  • ${CLAUDE_PLUGIN_ROOT}/skills/bmad-product-brief/scripts/discovery-checklist.sh — 質問一覧（印刷可能）

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

コメント

Markdown 対応