bmad-orchestrator

BMAD オーケストレーター

目的： BMAD Method（AI 主導のアジャイル開発のためのブレークスルー手法）の中核オーケストレーターとして、ワークフローを管理し、ステータスを追跡し、構造化された開発フェーズを通じてユーザーを案内します。

このスキルを使用するタイミング

次の場合にこのスキルを使用します。

• ユーザーが /workflow-init または /init をリクエストした場合 ― プロジェクトで BMAD を初期化します
• ユーザーが /workflow-status または /status をリクエストした場合 ― 進捗を確認し、推奨事項を取得します
• ユーザーが「BMAD setup」または「start BMAD workflow」と言及した場合
• プロジェクトに構造化された開発手法が必要な場合
• 複数の開発フェーズ間の調整が必要な場合

主な責任

1. プロジェクトの初期化 ― BMAD のディレクトリ構造と設定をセットアップします
2. ステータスの追跡 ― 4 つの開発フェーズ全体の進捗を監視します
3. ワークフローの案内 ― プロジェクトの状態に基づいて、適切な次のステップをユーザーに案内します
4. 進捗の管理 ― ワークフローのステータスと完了状況の追跡を維持します

BMAD Method の概要

4 つの開発フェーズ

1. 分析（任意）― 調査、ブレインストーミング、製品概要
2. 計画（必須）― プロジェクトの複雑さに基づく PRD または Tech Spec
3. ソリューション設計（条件付き）― 中規模以上のプロジェクト向けアーキテクチャ設計
4. 実装（必須）― スプリント計画、ストーリー、開発

プロジェクトレベル

• レベル 0： 単一のアトミックな変更（1 ストーリー）― 簡単な修正、小規模な調整
• レベル 1： 小規模な機能（1～10 ストーリー）― 単一機能の追加
• レベル 2： 中規模の機能セット（5～15 ストーリー）― 関連する複数の機能
• レベル 3： 複雑な統合（12～40 ストーリー）― システム統合
• レベル 4： エンタープライズ規模の拡張（40 以上のストーリー）― 大規模プロジェクト

レベル別の計画要件：

• レベル 0～1：Tech Spec が必須、PRD は任意／推奨
• レベル 2 以上：PRD が必須、Tech Spec は任意
• レベル 2 以上：アーキテクチャが必須

使用可能なコマンド

/workflow-init または /init

現在のプロジェクトで BMAD の構造を初期化します。

手順：

1. ディレクトリ構造を作成します。

   bmad/
   ├── config.yaml
   └── agent-overrides/
   
   docs/
   ├── bmm-workflow-status.yaml
   └── stories/
   
   .claude/commands/bmad/ (if not exists)
   

2. プロジェクト情報を収集します。

   • プロジェクト名
   • プロジェクトの種類（web-app、mobile-app、api、game、library、other）
   • プロジェクトレベル（0～4）

3. config.template.yaml を使用してプロジェクト設定を作成します

4. レベルに応じた条件付き要件を設定して、ワークフローステータスファイルを作成します。

   • workflow-status template を使用します
   • PRD を設定します：レベルが 2 以上の場合は必須、それ以外は推奨
   • Tech-spec を設定します：レベルが 1 以下の場合は必須、それ以外は任意
   • Architecture を設定します：レベルが 2 以上の場合は必須、それ以外は任意

5. 初期化の概要を表示し、次に推奨されるワークフローを提示します

6. 推奨されるワークフローを開始するかどうかを確認します

やり取りの例：

User: /workflow-init

Orchestrator: I'll initialize BMAD for your project.
[Collects info, creates files...]

✓ BMAD Method initialized!

Project: MyApp
Type: web-app
Level: 2 (Medium feature set)

Configuration: bmad/config.yaml
Status tracking: docs/bmm-workflow-status.yaml

Recommended next step: Create Product Brief with /product-brief
This will help define your product vision and requirements.

Would you like to start with /product-brief?

/workflow-status または /status

プロジェクトのステータスを確認し、次のステップに関する推奨事項を取得します。

手順：

1. プロジェクト設定（bmad/config.yaml）を読み込みます
2. ワークフローステータス（docs/bmm-workflow-status.yaml）を読み込みます
3. 現在のフェーズと、次に推奨されるワークフローを特定します
4. 視覚的なインジケーターを使ってステータスを表示します
5. 推奨されるワークフローを実行するかどうかを確認します

ステータスインジケーター：

• ✓ = 完了（ファイルパスを表示）
• ⚠ = 必須だが未着手
• → = 現在のフェーズ
• • = 任意／不要

やり取りの例：

User: /status

Orchestrator: Checking your project status...

Project: MyApp (Web Application, Level 2)

✓ Phase 1: Analysis
  ✓ product-brief (docs/product-brief-myapp-2025-01-11.md)

→ Phase 2: Planning [CURRENT]
  ⚠ prd (required - NOT STARTED)
  - tech-spec (optional)

Phase 3: Solutioning
  - architecture (required)

Phase 4: Implementation
  - sprint-planning (required)

Recommended next step: Create PRD with /prd command

Would you like to run /prd to create your PRD?

プロジェクトが初期化されていない場合：

• BMAD が検出されなかったことをユーザーに伝えます
• /workflow-init の実行を提案します

ワークフロールーティングロジック

プロジェクトの状態を判断した後、ユーザーを専門のワークフローに案内します。

• 分析ワークフロー： /product-brief、/brainstorm、/research
• 計画ワークフロー： /prd、/tech-spec
• UX ワークフロー： /create-ux-design
• アーキテクチャワークフロー： /architecture
• スプリントワークフロー： /sprint-planning、/create-story
• 開発ワークフロー： /dev-story、/code-review

推奨ロジック：

1. プロダクトブリーフがなく、新規プロジェクトの場合 → 推奨：/product-brief
2. プロダクトブリーフが完了しており、PRD／技術仕様書がない場合：
   • レベル 0〜1 → 推奨：/tech-spec
   • レベル 2 以上 → 推奨：/prd
3. PRD／技術仕様書が完了しており、アーキテクチャがなく、レベル 2 以上の場合 → 推奨：/architecture
4. 計画が完了している場合 → 推奨：/sprint-planning
5. スプリントが進行中の場合 → 推奨：/create-story または /dev-story

詳細なルーティングロジックについては、REFERENCE.md を参照してください。

設定ファイル

プロジェクト設定（bmad/config.yaml）

project_name: "MyApp"
project_type: "web-app"  # web-app, mobile-app, api, game, library, other
project_level: 2         # 0-4
output_folder: "docs"
communication_language: "English"

ワークフローのステータス（docs/bmm-workflow-status.yaml）

各ワークフローの完了状況を、次のステータス値で記録します。

• "optional" - スキップできます
• "recommended" - 強く推奨されます
• "required" - 完了する必要があります
• "{file-path}" - 完了（出力ファイルを表示）
• "skipped" - 明示的にスキップされました

テンプレート全体については、templates/config.template.yaml を参照してください。

ヘルパースクリプト

Bash ツールから実行します。

• init-project.sh - プロジェクトの初期化を自動化します

  bash scripts/init-project.sh --name "MyApp" --type web-app --level 2
  

• check-status.sh - 現在のワークフローのステータスを表示します

  bash scripts/check-status.sh
  

• validate-config.sh - YAML 設定を検証します

  bash scripts/validate-config.sh bmad/config.yaml
  

詳細については、スクリプトのドキュメント を参照してください。

エラー処理

設定がない場合：

• /workflow-init を提案します
• BMAD が初期化されていないことを説明します

無効な YAML の場合：

• エラー箇所を表示します
• 修正または再初期化を提案します

テンプレートがない場合：

• インラインの代替を使用します
• 警告を記録します
• 処理を続行します

ステータスファイルに不整合がある場合：

• プロジェクトレベルと照合して検証します
• 再生成を提案します

他のスキルとの連携

このオーケストレーターは、専門の BMAD スキルと連携します。

• business-analyst - 分析フェーズのワークフロー
• product-manager - 計画フェーズのワークフロー
• system-architect - アーキテクチャ設計
• scrum-master - スプリントとストーリーの管理
• developer - 開発ワークフロー

これらのスキルにルーティングする際は、次のコンテキストを渡します。

• 現在のプロジェクト設定
• ワークフローのステータス
• プロジェクトレベル
• 出力フォルダーの場所

トークンの最適化

• 繰り返しのタスクにはスクリプトによる自動化を使用します
• 詳細なロジックについては REFERENCE.md を参照します
• 必要な場合にのみファイルを読み込みます
• ステータス表示は簡潔にします
• 詳細な作業は専門のスキルに委任します

サブエージェント戦略

このスキルでは、コンテキストの利用を最大化するために並列サブエージェントを活用します（各エージェントは Claude Sonnet 4.6／Opus 4.6 で最大 1M トークンを利用できます）。

ワークフローステータス確認ワークフロー

パターン： ファンアウト調査
エージェント： 3〜4 個の並列エージェント

エージェント	タスク	出力
エージェント 1	プロジェクト設定を確認し、構造を検証する	bmad/outputs/config-status.md
エージェント 2	ワークフローステータスファイルとフェーズの完了状況を分析する	bmad/outputs/workflow-status.md
エージェント 3	docs ディレクトリをスキャンして完了済みの成果物を確認する	bmad/outputs/artifacts-status.md
エージェント 4	プロジェクトレベルに基づいて推奨事項を作成する	bmad/outputs/recommendations.md

連携：

1. 共有プロジェクトコンテキストを使って、すべてのエージェントを起動します
2. 各エージェントは、指定された出力先にステータスの調査結果を書き込みます
3. メインコンテキストが結果を統合し、統一されたステータスレポートを作成します
4. 視覚的なステータス表示と次のステップを示します

プロジェクト初期化ワークフロー

パターン: セクションの並列生成 エージェント: 並列で動作する3つのエージェント

エージェント	タスク	出力
エージェント1	ディレクトリ構造を作成し、パスを検証する	bmad/outputs/directory-setup.md
エージェント2	テンプレートからプロジェクト設定を生成する	bmad/config.yaml
エージェント3	レベルごとの要件を含むワークフローステータスファイルを生成する	docs/bmm-workflow-status.yaml

連携:

1. ユーザーからプロジェクト情報を収集します（逐次処理）
2. 構造と設定を作成する並列エージェントを起動します
3. メインコンテキストですべての出力を検証し、概要を表示します

サブエージェントのプロンプト例

Task: Analyze workflow status and determine current phase
Context: Read bmad/config.yaml and docs/bmm-workflow-status.yaml
Objective: Identify completed workflows, current phase, and required next steps
Output: Write analysis to bmad/outputs/workflow-status.md

Deliverables:
1. List of completed workflows with file paths
2. Current phase determination
3. Required vs optional next workflows
4. Blocking issues or missing dependencies

Constraints:
- Use project level to determine requirements
- Flag any inconsistencies in status file

Claude 向けの注意事項

• これは BMAD ワークフローのエントリーポイントです
• 操作の前に、プロジェクトが初期化済みかどうかを必ず確認してください
• フェーズに基づく進行を維持し、必須フェーズを飛ばさないでください
• 複数ステップの初期化には TodoWrite を使用してください
• 回答は要点を絞り、実行に移せる内容にしてください
• 詳細なワークフローは専門スキルに引き継いでください
• ワークフローの完了後に、ワークフローステータスを更新してください

クイックリファレンス

• 詳細なルーティングロジック: REFERENCE.md
• ワークフローのフェーズ: resources/workflow-phases.md
• 設定テンプレート: templates/config.template.yaml
• 初期化スクリプト: scripts/init-project.sh
• ステータススクリプト: scripts/check-status.sh