Blueprint — 建設計画ジェネレーター は何をしますか?
一行の objective を、どのコーディングエージェントでも cold 実行できるステップバイステップの建設計画に変換します。
使用場面
- 大きな機能を依存関係の明確な複数の PR に分割する
- 複数セッションにまたがるリファクタリングや移行を計画する
- サブエージェント間で並行ワークストリームを調整する
- セッション間のコンテキスト損失により再作業が発生する可能性のあるあらゆるタスク
使用しないほうがよい場合 — 1 つの PR で完了するタスク、3 回未満のツール呼び出しで済むタスク、ユーザーが「とにかくやって」と言っている場合。
仕組み
Blueprint は 5 フェーズのパイプラインで動作します:
- 調査 — 事前チェック(git、gh auth、リモート、デフォルトブランチ)を実行し、プロジェクト構造、既存の計画、メモリファイルを読み込んでコンテキストを収集します。
- 設計 — 目的を 1 PR サイズのステップ(通常 3~12 個)に分割します。各ステップに依存関係エッジ、直列/並列順序、モデル階層(最強 vs デフォルト)、ロールバック戦略を割り当てます。
- 草稿 — 自己完結型の Markdown 計画ファイルを
plans/に書き込みます。各ステップにはコンテキスト概要、タスクリスト、検証コマンド、終了条件が含まれているため、新しいエージェントでも前のステップを読まずに実行できます。 - レビュー — チェックリストとアンチパターンカタログに基づいて、最強モデルのサブエージェント(例: Opus)に敵対的レビューを委任します。最終決定前にすべての重大な問題を修正します。
- 登録 — 計画を保存し、メモリインデックスを更新し、ステップ数と並列性の概要をユーザーに提示します。
Blueprint は git/gh の可用性を自動検出します。Git + GitHub CLI がある場合は完全なブランチ/PR/CI ワークフロー計画を生成し、ない場合は直接モード(その場で編集、ブランチなし)に切り替えます。
例
基本的な使用法
/blueprint myapp "データベースを PostgreSQL に移行する"
plans/myapp-migrate-database-to-postgresql.md を生成し、以下のようなステップが含まれます:
- ステップ 1: PostgreSQL ドライバーと接続設定を追加
- ステップ 2: 各テーブルのマイグレーションスクリプトを作成
- ステップ 3: リポジトリ層を新しいドライバーを使用するように更新
- ステップ 4: PostgreSQL に対する統合テストを追加
- ステップ 5: 古いデータベースコードと設定を削除
マルチエージェントプロジェクト
/blueprint chatbot "LLM プロバイダーをプラグインシステムに抽出する"
可能な限り並列ステップ(例: 「Anthropic プラグインの実装」と「OpenAI プラグインの実装」はプラグインインターフェースステップの後に並列実行)を含む計画を生成し、モデル階層の割り当て(インターフェース設計ステップには最強モデル、実装にはデフォルト)、すべてのステップ後に検証される不変条件(例: 「既存のテストがすべてパスする」「コアにプロバイダーのインポートがない」)を含みます。
主な機能
- Cold スタート実行 — 各ステップに自己完結型のコンテキスト概要が含まれています。事前のコンテキストは不要です。
- 敵対的レビューゲート — すべての計画は、完全性、依存関係の正確性、アンチパターン検出をカバーするチェックリストに基づいて、最強モデルのサブエージェントによってレビューされます。
- ブランチ/PR/CI ワークフロー — すべてのステップに組み込まれています。git/gh がない場合は直接モードに自動的に低下します。
- 並列ステップ検出 — 依存関係グラフにより、共有ファイルや出力依存関係のないステップを特定します。
- 計画変更プロトコル — ステップの分割、挿入、スキップ、並べ替え、破棄を正式なプロトコルと監査証跡で行えます。
- 実行時リスクゼロ — 純粋な Markdown スキルです。リポジトリ全体が
.mdファイルのみで構成されています — フック、シェルスクリプト、実行可能コード、package.json、ビルドステップは一切ありません。インストール時や呼び出し時に Claude Code のネイティブ Markdown スキルローダー以外は何も実行されません。
インストール
このスキルは Everything Claude Code に同梱されています。ECC がインストールされていれば、個別のインストールは不要です。
ECC フルインストール
ECC リポジトリのチェックアウトから作業している場合は、次のコマンドでスキルが存在することを確認してください:
test -f skills/blueprint/SKILL.md
後で更新する場合は、更新前に ECC の差分を確認してください:
cd /path/to/everything-claude-code
git fetch origin main
git log --oneline HEAD..origin/main # 更新前に新しいコミットを確認
git checkout <reviewed-full-sha> # 確認済みの特定のコミットに固定
ベンダースタンドアロンインストール
ECC フルインストールの外部でこのスキルのみをベンダリングする場合は、ECC リポジトリから確認済みファイルを ~/.claude/skills/blueprint/SKILL.md にコピーしてください。ベンダリングされたコピーには git リモートがないため、git pull ではなく、確認済みの ECC コミットからファイルを再コピーして更新します。
必要条件
- Claude Code(
/blueprintスラッシュコマンド用) - Git + GitHub CLI(オプション — 完全なブランチ/PR/CI ワークフローを有効にします。Blueprint は不在を検出して自動的に直接モードに切り替えます)
出典
antbotlab/blueprint に触発されました — 上流プロジェクトおよびリファレンスデザイン。