bmad-help

BMAD ヘルプ — オーケストレーションの中核

軽量なルーターです。答えるのは「次に何を実行すればよいか？」という1つの質問だけです。計画の状態を検出し、フェーズとトラックを推定して、次のスキルを案内します。セッションの方向性を示すために自動的に呼び出され、重量級のマスター／オーケストレーターエージェントに代わります。

このスキルは計画ドキュメントを一切作成しません。 状態を読み取り、推奨事項を提示します。すべての成果物は、案内先となる専門の計画スキルによって作成されます。

使用するタイミング

• ユーザーが「次は何をするのか」「今どこにいるのか」「現在の状況はどうか」「続けて」「再開して」と尋ねたとき。
• 計画作業に入る前に方向性を確認するため、あらゆる BMAD セッションの開始時。
• ユーザーがどのスキルを呼び出すべきか分からないとき。

フェーズマップ

Analysis  ──►  Planning  ──►  Solutioning  ──►  Implementation-handoff
(optional)     (required)     (conditional)     (required: ready-for-dev stories)

フェーズ	成果物	スキル
分析（任意）	product-brief、research、brainstorm	bmad-product-brief / bmad-research / bmad-brainstorm
計画（必須）	prd.md または tech-spec.md、epics.md	bmad-prd / bmad-tech-spec / bmad-epics-and-stories
計画 — UX（UI がある場合のみ）	ux-design.md	bmad-ux
ソリューション設計（トラックに依存）	architecture.md	bmad-architecture
実装への引き継ぎ（必須）	{epic}.{story}.{slug}.story.md (ready-for-dev)	bmad-epics-and-stories → bmad-sprint-planning

すべてのフェーズを通じて維持されるもの：project-context.md（プロジェクトの「基本方針」）と decision-log.md（ワークフロー間で引き継がれる決定事項）です。これらがない場合、最初に必ず推奨されるのは、これらを整備することです。

実装そのもの（コードの記述、テストの実行）は対象外です。このプラグインが作成する最後の成果物は、開発ツールに渡す ready-for-dev のストーリーファイルまたは引き継ぎマニフェストです。

トラック（規模に適応 — 番号付きのレベルは使用しません）

ヒューリスティックによってストーリー数からトラックを提案することがありますが、ユーザーが確認します。

トラック	範囲	必須の計画	任意
Quick Flow	ストーリー1～15件	tech-spec + stories	分析、UX
BMad Method	ストーリー10～50件以上	prd + architecture + epics + stories	分析、UX（UI がある場合）
Enterprise	ストーリー30件以上	prd + architecture + security + devops + epics + stories	分析

トラックごとの必須ステップと任意ステップの詳細については、 REFERENCE.mdを参照してください。

仕組み

1. 状態を検出します。 検出器を実行して、存在する成果物と推定フェーズを一覧表示します。

   bash ${CLAUDE_PLUGIN_ROOT}/skills/bmad-help/scripts/detect-state.sh [output-folder]
   

   デフォルトの出力フォルダーは bmad-output/ です。成果物のチェックリスト（存在するもの、または不足しているもの）、検出されたトラック（記録がある場合は decision-log から取得）、推定フェーズが表示されます。

2. 次のステップを推奨します。 検出された状態を次のスキルに対応付けます。

   bash ${CLAUDE_PLUGIN_ROOT}/skills/bmad-help/scripts/recommend-next.sh [output-folder]
   

   次に実行するスキルを1つだけ、その理由、およびスキップされた任意のフェーズとともに表示します。

3. 推奨事項を平易な文章でユーザーに提示します。推奨スキルの呼び出しを提案してください。トラックがまだ曖昧な場合は、確認を得ずに計画スキルを自動実行しないでください。

project-context.md がまだ存在しない場合、プロジェクトは未初期化として扱います。推奨されるのは、bmad-init（または、任意の分析フェーズを先に行いたい場合は bmad-product-brief）から開始して、プロジェクトのコンテキストを整備し、トラックを選択することです。

ルーティングロジック（概要）

順に評価し、現在のトラックで最初に未完了のステップを推奨します。

1. project-context.md がない → プロジェクトコンテキストを確立します（bmad-init を実行するか、ユーザーが分析を選択した場合は bmad-product-brief を実行します）。トラックを確認します。
2. prd.md も tech-spec.md もない →
   • Quick Flow → bmad-tech-spec（tech-spec）。
   • BMad Method / Enterprise → bmad-prd（PRD）。
3. プロジェクトに UI があり、ux-design.md がない（BMad/Enterprise）→ bmad-ux。
4. トラックでアーキテクチャが必要で、architecture.md がない（BMad/Enterprise）→ bmad-architecture。（Quick Flow ではアーキテクチャを省略します。）
5. Enterprise でセキュリティ／DevOps の計画がない → bmad-architecture（セキュリティと DevOps の セクション／引き継ぎ）。
6. epics.md がない（BMad/Enterprise）→ bmad-epics-and-stories（エピックの分割）。
7. stories/ の下にストーリーファイルがない → bmad-epics-and-stories（開発可能な状態のストーリーを作成）。
8. ストーリーは存在するものの、一部がまだ backlog／ready-for-dev ではない → bmad-epics-and-stories （ストーリーコンテキストオブジェクトの作成を完了）。その後、bmad-sprint-planning で作業の順序を決めます。
9. 必要な成果物がすべてそろい、ストーリーが ready-for-dev になっている → 引き継ぎ 完了。 ストーリーを外部の開発ツールに引き渡すことを推奨します。計画することは 残っていません。

スキップ規則： 分析は常に任意です。分析の完了を必須にしないでください。UX を推奨するのは、プロジェクトに UI がある場合のみです。Quick Flow ではアーキテクチャを省略します。

エッジケースを含む完全な判断表：REFERENCE.md。

Claude への注意事項

• ここがエントリーポイントです。推奨する前に必ず状態を検出してください。
• 次に推奨するスキルは必ず 1 つだけにしてください。実行可能な内容にします。
• ここで計画文書を作成しないでください。担当スキルにルーティングしてください。
• テスト、ビルド、リンターの実行やコードの作成は推奨しないでください。これらはこのプラグインの対象範囲外です。
• ロックされたセクションを尊重してください。ストーリーファイルの Acceptance Criteria、Dev Notes、Testing は計画スキルが管理しており、後続の工程で編集してはいけません。
• 確認済みのトラックを読み取るには decision-log.md を使用してください。ファイルがない場合は、トラックに応じたステップを推奨する前に、ユーザーにトラックの確認を求めてください。

---

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