bmad-builder

BMAD Builder

機能： BMAD Planning & Orchestrator プラグイン用のカスタム計画／オーケストレーションスキルをスキャフォールドし、検証します。このプラグインのパス規則にあらかじめ対応した準拠済みの SKILL.md ファイル、シェルスクリプト、テンプレートを生成し、スコープ違反チェックを実行して、新しいスキルが PLAN／ORCHESTRATE の境界内に収まるようにします。

スコープ（PLAN、実装はしない）

このスキルが生成するのは、計画成果物とスキルのひな形ファイルです。アプリケーションコードの作成、テストの実行、Lint、カバレッジの確認、ビルドの実行は行いません。設計中のスキルが「実装する」「コードを修正する」「テストスイートを実行する」「差分をレビューする」ことを試みる場合は、スコープ違反です。代わりに計画を立て、引き継いでください。

3 つのインテント

開始前に、該当するインテントを必ず確認してください。

Create — 新しい計画スキルを一から作成する

1. 要件を収集します（TodoWrite を使って追跡します）：

   • スキル名（小文字とハイフンを使用し、bmad- を接頭辞にする。例：bmad-example）
   • 解決する計画／オーケストレーション上の課題
   • ユーザーが使うトリガーフレーズ
   • 使用を許可するツール（次の一部：Read、Write、Edit、Bash、Glob、Grep、WebSearch、WebFetch、TodoWrite）
   • 適用する BMAD トラック（Quick Flow ／ BMad Method ／ Enterprise）
   • 上流の BMAD 対応スキル（例：bmad-risk-assessment）

2. スキャフォールドスクリプトを実行してディレクトリを作成します：

   bash ${CLAUDE_PLUGIN_ROOT}/skills/bmad-builder/scripts/scaffold-skill.sh <skill-name>
   

   これにより、scripts/ と templates/ サブディレクトリ、および初期状態の SKILL.md を含む skills/<skill-name>/ が作成されます。

3. スキルテンプレートを使って SKILL.md を仕上げます：

   • 参照先：${CLAUDE_PLUGIN_ROOT}/skills/bmad-builder/templates/skill.template.md
   • 本文は 5K トークン未満にします。長い参照情報は、新しいスキルのフォルダー内にある兄弟ファイル REFERENCE.md に移します。
   • バンドルされたスクリプト／テンプレートへのすべてのパスに ${CLAUDE_PLUGIN_ROOT} を使用します。
   • 成果物の保存先は bmad-output/ とします（ユーザーが設定したフォルダーを尊重してください）。
   • 必須の帰属表示フッターを末尾に付けます（テンプレートを参照）。

4. 新しいスキルを検証します：

   bash ${CLAUDE_PLUGIN_ROOT}/skills/bmad-builder/scripts/validate-skill.sh \
     ${CLAUDE_PLUGIN_ROOT}/skills/<skill-name>/SKILL.md
   

   完了を宣言する前に、すべてのエラーを修正し、警告をすべて確認してください。

Validate — 既存の SKILL.md を確認する

任意の SKILL.md のパスを指定して、バリデーターを直接実行します：

bash ${CLAUDE_PLUGIN_ROOT}/skills/bmad-builder/scripts/validate-skill.sh <path-to-SKILL.md>

バリデーターは次の項目を確認します：

• name フィールドがあり、小文字とハイフンで記述されていること
• description フィールドがあり、トリガーフレーズが含まれていること
• allowed-tools フィールドがあること（ない場合は警告）
• allowed-tools または本文に、開発／Lint／ビルド／カバレッジのスコープ違反がないこと
• ファイルサイズが約 5K トークン（約 20KB）の目標範囲内であること
• 帰属表示フッターがあること

Scaffold — ディレクトリ構造のみ

内容を生成せず、空のディレクトリのひな形だけが必要な場合に使います：

bash ${CLAUDE_PLUGIN_ROOT}/skills/bmad-builder/scripts/scaffold-skill.sh <skill-name>

その後、テンプレートを参考にして SKILL.md を手動で作成します。

新しいスキルのスコープ規則

このビルダーで作成するすべてのスキルは、スコープ規則に準拠する必要があります。

• このプラグインが行うのは、計画とオーケストレーションです。アプリケーションコードの作成、テストの実行、Lint、カバレッジの確認、ビルド、実装済みコードのレビューは決して行いません。
• スキルが生成できる最後の成果物は、開発準備が整ったストーリーファイル、または引き継ぎマニフェストです。実装は EXTERNAL の開発ツール／プラグインに引き継ぎます。
• 受け入れ基準、テスト STRATEGY、開発メモは計画に該当するため許可されます。テストの実行や実装コードの作成はスコープ外です。

validate-skill.sh スクリプトは、禁止用語を検出してこの規則を自動的に適用します。

BMAD への準拠に関する注意事項

スキルを設計するときは、BMAD Method の規則に従ってください。

規則	ルール
Scale Tracks	Quick Flow ／ BMad Method ／ Enterprise — ユーザーが対話形式で確認します
ストーリーの規模	約 2～8 時間、最大 1 開発日。これを超える場合は分割します
デリバリーの追跡	残りのストーリー数／完了率 — フィボナッチポイント、ベロシティ、バーンダウンは使用しません
ストーリー名	{epic}.{story}.{slug}.story.md
ストーリーのステータス	backlog → ready-for-dev → in-progress → review → done
意思決定ログ	意思決定は decision-log.md に記録します
プロジェクト憲章	project-context.md を複数のスキルで読み込みます
3 つのインテント	該当する場合は Create ／ Update ／ Validate

利用可能なスクリプト

スクリプト	用途
scripts/scaffold-skill.sh <name>	サブディレクトリとスターターの SKILL.md を含む skills/<name>/ を作成します
scripts/validate-skill.sh <SKILL.md>	フロントマター、スコープ、サイズ、帰属表示のフッターを検証します

上記に示す ${CLAUDE_PLUGIN_ROOT} プレフィックスを付けて実行してください。オーケストレーターがスクリプトを実行可能にします。bash 経由で実行することもできます。

テンプレート

テンプレート	用途
templates/skill.template.md	新しい計画／オーケストレーション用 SKILL.md のひな形
templates/document.template.md	汎用の計画ドキュメント（PRD セクション、概要、仕様セクションなど）

サブエージェント戦略

スキルパッケージ全体を並行して作成する場合：

エージェント	タスク	出力
エージェント 1	収集した要件に基づいて SKILL.md の本文を作成	skills/<name>/SKILL.md
エージェント 2	ドメイン用スクリプト（バリデーター、チェックリスト）を作成	skills/<name>/scripts/
エージェント 3	ドメイン用テンプレートを作成	skills/<name>/templates/
エージェント 4	本文が 5K トークンを超える場合は REFERENCE.md を作成	skills/<name>/REFERENCE.md

連携手順：まず順番に要件を収集し、仕様を bmad-output/skill-spec.md に記述してから、作業を分担します。メインコンテキストですべての出力を validate-skill.sh で検証し、最終パッケージを組み立てます。

LLM 向けの注意事項

• 作成したコンポーネントを追跡するには、TodoWrite を使用してください。
• テストランナー、リンター、カバレッジツール、ビルドコマンド、差分／コードレビューの手順を含むスキルは作成しないでください。validate-skill.sh によって検出されます。
• SKILL.md は必ず帰属表示のフッターブロックで終えてください（テンプレートにそのまま含まれています）。
• SKILL.md は 5K トークン未満にしてください。長いパターンには REFERENCE.md を使用してください。
• すべての内部パスには ${CLAUDE_PLUGIN_ROOT} を使用してください。~/.claude やマシン上の絶対パスをハードコードしないでください。
• 出力成果物（スキル以外のファイル）は、デフォルトで bmad-output/ に配置してください。

---

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