bmad-init

BMAD Init — ワークスペースのスキャフォールダー

計画ワークスペースを設定し、BMAD の後続の計画ワークフロー全体を拡張する TRACK を選択します。これは計画スキルです。フォルダーと初期ドキュメントのみを作成します。アプリケーションコードの作成、テストの実行、ビルドは行いません。

作成されるもの

設定された出力フォルダー（デフォルトは bmad-output/）の下に、次のものが作成されます。

bmad-output/
├── config.yaml          # project name, track, output paths, languages
├── decision-log.md      # empty threaded decision log (grows across workflows)
├── project-context.md   # the project "constitution" loaded by every later skill
└── stories/             # empty; future story files land here

config.yaml は、他のスキルが出力フォルダーと選択されたトラックを確認するために参照する唯一の信頼できる情報源です。

3 つの TRACK（番号付きのレベルではありません）

トラック	ストーリー数	計画成果物
Quick Flow	1～15 ストーリー	tech-spec のみ
BMad Method	10～50 件以上のストーリー	PRD + Architecture（+ UX は任意）
Enterprise	30 件以上のストーリー	PRD + Architecture + Security + DevOps 計画

トラックは、ポイント数やベロシティではなく、計画上の必要性に基づいて決定します。ストーリー数は大まかな目安にすぎません。スコープ、チーム間の調整、リスクを基準に判断してください。ヒューリスティックでデフォルトを提案する場合もありますが、必ずユーザーに確認してもらいます。

ワークフロー

1. 既存のワークスペースを確認します。 bmad-output/config.yaml（またはユーザーが指定したカスタム出力フォルダー）を Glob で検索します。存在する場合は内容を読み、維持するか、冪等に再実行するか（安全です。既存ファイルは保持されます）、トラックを変更するかを尋ねます。内容が入力済みの decision-log.md や project-context.md を上書きしないでください。

2. 会話の中で大まかなスコープの情報を集めます（質問攻めにしないでください）。

   • プロジェクトの概要を一文で。
   • 作業項目／ストーリーはおよそいくつありますか？（範囲でもかまいません）
   • 複数のチームですか、それとも担当者は一人ですか？
   • 厳格なコンプライアンス／セキュリティ／インフラ要件はありますか？

3. トラックを提案します。 ヘルパーを実行して 3 つのトラックと提案するデフォルトを表示し、その後、推奨案を伝えて、ユーザーに確認または変更を依頼します。

   bash "${CLAUDE_PLUGIN_ROOT}/skills/bmad-init/scripts/select-track.sh" --stories <N> --teams <one|many> --compliance <yes|no>
   

   ヘルパーが適用するヒューリスティック（状況に応じて判断を調整してもかまいません）。

   • コンプライアンス／インフラ要件がある、またはストーリー数が 30 件以上 → Enterprise
   • ストーリー数が 10 件以上、または PRD／Architecture が明らかに必要 → BMad Method
   • それ以外 → Quick Flow

4. スキャフォールドします。 ユーザーがプロジェクト名とトラックを確認したら、次を実行します。

   bash "${CLAUDE_PLUGIN_ROOT}/skills/bmad-init/scripts/init-project.sh" \
     --name "<project name>" \
     --track <quick-flow|bmad-method|enterprise> \
     --output "bmad-output"
   

   このスクリプトは冪等です。不足しているフォルダーを作成し、不足しているテンプレートファイルを初期作成しますが、すでに内容がある decision-log.md や project-context.md は上書きしません。config.yaml は常に（再）書き込みます。

5. 憲章を開きます。 ユーザーが project-context.md の最初のセクション（プロジェクトの目標、主要なユーザー、制約、対象外事項）を記入できるよう案内します。これは後続のすべてのスキルが読み込むドキュメントなので、ここにいくつか良い文章を書いておくと役立ちます。トラックの選択とその理由を、decision-log.md の最初の項目として記録します。

6. 次のステップを案内します。 トラックに基づいて、次の計画ステップを提案します。

   • Quick Flow → tech-spec、その後 sprint-planning ／ストーリー作成。
   • BMad Method → product brief → PRD → architecture。
   • Enterprise → product brief → PRD → architecture（+ セキュリティおよび DevOps 計画）。

3 つのインテント

• 作成 — 新しいワークスペース（一般的なケース）。
• 更新 — トラックを変更する、またはプロジェクト名を変更する場合：config.yaml を編集し、変更内容を日付と理由とともに decision-log.md に追記します。他のファイルは消去しないでください。
• 検証 — ワークスペースが正しい形式か確認します。

  bash "${CLAUDE_PLUGIN_ROOT}/skills/bmad-init/scripts/init-project.sh" --validate --output "bmad-output"
  

ガードレール

• 番号付きのレベルは一切設けません。名前付きの3つのトラックのみを使用します。
• ストーリーポイント、ベロシティ、バーンダウンは使用しません。進捗は件数ベース（残りのストーリー数／完了率）で管理します。ストーリーのサイズは、1回のエージェントセッション（約2～8時間）で完了できる程度を目標とします。それより大きなものはすべて分割してください。
• このスキルは足場作りまでを担当します。他の計画スキルに引き継ぎ、実装、テスト、リント、ビルドは行いません。

完全な設定スキーマ、トラック選択の詳細、プロジェクトコンテキストのセクションガイドについては、REFERENCE.mdを参照してください。

---

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