Blueprint

Blueprintとは？

Blueprintはコーディングエージェント向けの計画コパイロットです。コード執筆前に適切な質問をエージェントに促し、一発で実行可能なMarkdown計画を生成します。

このツールはエージェント非依存で設計されており、Q&A駆動の計画を採用：コードベースを探索し、簡単に答えられる選択式質問を投げかけます。出力は考慮し損なう可能性のある問題や決定事項を表面化し、再利用可能な仕様/計画として構造化されます。

コード前のQ&A計画：実行を適度に遅らせ要件を明確化し、構造化された計画を生成します。
コードベース探索：ワークスペース/コードベースを読み込み、その文脈に基づいて質問を駆動します。
選択式質問：素早く答えられる形式で、重要な曖昧さをカバーします。
Markdown計画出力：コーディングエージェントに直接引き継げるMarkdownファイルとして結果を出力します。
エージェント非依存スキル（skills.sh対応）：複数のコーディングエージェントハーネスに対応したスキルとしてパッケージ化されています。
オープン質問セクション付きテンプレート：概要、期待動作、実装フェーズ、テスト戦略、オープン質問などのセクションを定義したデフォルト計画テンプレートを内蔵。

スキルのインストール：リポジトリに記載のnpxコマンドを使用：npx skills add imbue-ai/blueprint。
計画セッションの開始：コーディングエージェントでスキルを発動し、短いタスク記述を指定（例：/blueprint Add a caching layer to reduce API calls）。
プロンプトでテンプレートを選択：Blueprintがコードベースを探索し、質問を開始します。
質問に回答：Blueprintが十分な情報が揃ったと判断するまで回答を続けます。
計画の生成：/blueprint-generateで計画を生成。blueprint/<slug>/plan-<slug>.md形式のパスに書き込まれます。
必要に応じてチャットで調整：計画をコーディングエージェントに引き継ぐ前にオープン質問を尋ねる（例：「what are the open questions?」）。

対応するコーディングエージェントハーネスは？ リポジトリによると、Claude Code, Codex CLI, Gemini CLI, Pi agent などのハーネスおよび互換ハーネスに対応。
生成された計画はどこに保存される？ /blueprint-generate実行後、blueprint/<slug>/plan-<slug>.mdに書き込まれます。
Blueprintに含まれるテンプレートは？ デフォルトで2つのビルトインテンプレート：Default（概要、期待動作、実装計画/フェーズ、テスト戦略、オープン質問を含むセクション）とConcise（概要、期待動作、変更を含むセクション）。
計画構造をカスタマイズ可能？ はい。リポジトリによると、プロンプト時にインラインでカスタムテンプレートを記述可能。また、templates.jsonで永続的に追加/編集し、2つのBlueprintスキルを同期。
フロントエンド作業限定？ READMEのガイダンスでは、視覚的決定が多いフロントエンドには不向きで、グリーンフィールドプロジェクト、大規模新機能、リサーチやサブシステム計画に適しています。

仕様書やドキュメント生成ツール（手動レビュー形式）：エージェントが独自の選択をした後に長い仕様書を生成するツールは、Blueprintと異なりワークフローを逆転させます—BlueprintはまずQ&Aであなたの入力を求めます。
コーディングエージェントツールの「計画モード」ワークフロー：一部のエージェントプラットフォームには独自の計画モードが含まれますが、Blueprintはエージェント実行可能なMarkdown計画を生成し、要件に焦点を当てた短い質問をする計画コパイロットとして位置づけられています。
汎用コードベースレビューアシスタント：代替案はリポジトリを要約・分析するかもしれませんが、Blueprintの特徴的な出力は、定義されたセクションと実行向けのオープン質問を含む構造化されたMarkdown計画です。
計画拡張機能を使ったVS Codeサイドバーワークフロー：エディタ統合ツールを好む場合、BlueprintはVS Code拡張機能としても利用可能で、VS Code, Cursor, and Windsurfで動作し、純粋なチャット駆動型エージェントセットアップとは異なります。