mcpField
B
blueprint

blueprint

github.com/camachoエージェントワークフロー239 回インストール
リポジトリ

blueprint について

blueprintは、タスクの標準 ai-env 計画を作成してコミットするためのスキルです。コーディングエージェントに前提条件の確認、1回のブレインストーミング、テンプレート記入、レビューへの引き継ぎを促し、実装は開始しません。

主な機能

  1. 01タスクとworktreeの前提条件確認
  2. 021回のブレインストーミング
  3. 03計画テンプレートの記入
  4. 04脅威モデルの選択
  5. 05レビュー前の計画コミット
  6. 06計画と実装の分離

活用シーン

  1. 01コーディング前の構造化計画作成
  2. 02具体的な実装・テスト手順の記録
  3. 03タスクの脅威モデル選定
  4. 04コミット済み計画のレビュー引き継ぎ

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/camacho/ai-skills --skill blueprint

インストール後、Claude Code で/blueprintを入力して読み込まれたか確認します。

同梱ファイルreferences/planning-quality.md

詳細

/blueprint

現在のタスクに対する正規の ai-env ブループリント（計画ファイル）を作成します。事前に /orient を実行しておく必要があります。

手順

  1. 前提条件を確認します。 ワークツリーが存在し、/orient でタスクが特定されていることを確認します。満たされていない場合は停止し、ユーザーに伝えます。
  2. ブレインストーミング（1ラウンド）を行います。 タスクの説明を使って /brainstorming を実行します。1ラウンドのみ実施し、方向性を把握します。反復はしません。
  3. テンプレートを読みます。 リポジトリのルートにある ai-workspace/plans/TEMPLATE.md を読みます。
  4. 計画を作成します。 ai-workspace/plans/<branch-slug>.md を作成し、テンプレートの全フィールドを埋めます。複雑な計画の場合は references/planning-quality.md を読み、チェックリストを適用します。参照ファイル全体を計画にコピーしてはいけません。
フィールド記入方法
ブランチ現在のブランチ名
ターゲットマージ先のブランチ。デフォルトは下記の方法で reflog から検出した親ブランチで、検出できない場合は main です。意図的に変更する場合のみ上書きします。/ship はこのフィールドを読み取ります。
作成日今日の日付（YYYY-MM-DD）
ステータスIn Progress
脅威モデル下記の選択表を参照
スコープ上限テンプレートのデフォルトを維持します（ソフト上限 400/6、ハード上限 800/10）。
タスク何を、なぜ行うのかを1～3文で記述します。
手順具体的な実装手順をチェックボックス形式で列挙します。
信頼度の足場adversarial では必須です。複雑な advisory では推奨されます。
成果と学び空欄のままにします。/archive が記入します。

  1. 計画をコミットします。 /review に引き継ぐ前に、計画ファイルをステージしてコミットします。

    git -C "$WORKTREE" add ai-workspace/plans/<name>.md
git -C "$WORKTREE" commit -m "blueprint: <name>"

/review はコミット済みの状態を対象に動作するため、これは必須です。計画を書いた後、/review を実行する前にセッションがクラッシュしたり /clear したりすると、ブレインストーミングの内容が失われます。この手順を省略した場合の復旧方法については、ADR-008（refs/wip/checkpoints/<branch> Stop-hook によるバックストップ）を参照してください。

ターゲットの検出

デフォルトのターゲットは、このブランチの作成元のブランチです。reflog から読み取ります。

TARGET=$(
  git reflog show HEAD --pretty=format:'%gs' \
    | grep "^branch: Created from" \
    | head -1 \
    | sed 's/branch: Created from //' \
    | sed 's|^origin/||'
)
TARGET=${TARGET:-main}

reflog が空の場合（ウェブセッション、detached HEAD での作成）は main にフォールバックします。ユーザーがターゲットを明示していない場合は、常にこの方法を使います。純粋な git 操作のため、ツールをインストールせず、どの環境でも動作します。

脅威モデルの選択

シグナルモデル
内部ツール、リファクタリング、ドキュメント、テスト、設定advisory
認証、シークレット、入力検証、CI、フック、権限adversarial
判断できない場合adversarial

ガードレール

  • ブループリントをレビューしてはいけません。それは /review の担当です（手順4）。
  • 実装を開始してはいけません。ブループリントが成果物です。
  • テンプレートのフィールドを省略してはいけません。
  • ブループリントファイルをコミットせずに /review に進んではいけません。
  • ブレインストーミングでタスクのスコープが1文で済むと判明した場合は、その旨を伝えてスキップします。
  • スコープ上限の値は固定です。変更してはいけません。
  • 手順は、曖昧なフェーズではなく、チェックボックス付きの具体的なアクションにします。
  • テスト手順を明示的に含めます。テストを別の担当者が作成する必要がある場合（TDD 契約）は、テストと実装を別々のタスクとして列挙し、/build がテスト作成者と実装担当者にそれぞれ割り当てるようにします。
  • 別の計画スキルを実行してはいけません。このスキルが ai-env の計画作成を担当します。

出力

作成後、次の内容を報告します。

Plan written: ai-workspace/plans/<name>.md
Threat model: advisory|adversarial
Steps: <count>
Next step: /review (Step 4)

コメント

Markdown 対応