Compound Engineering Setup

インタラクション方法

以下の各質問をプラットフォームのブロッキング質問ツールを使用してユーザーに提示してください: Claude Code の AskUserQuestion (スキーマが読み込まれていない場合は ToolSearch で select:AskUserQuestion を呼び出す)、Codex の request_user_input、Gemini の ask_user、Pi の ask_user (pi-ask-user 拡張が必要)。ハーネスにブロッキングツールが存在しないか呼び出しがエラーになった場合 (Codex 編集モードなど) は、スキーマ読み込みが必要な場合のみではなく、チャットで番号付きリストとして各質問を提示することにフォールバックしてください。決してサイレントにスキップしたり自動設定したりしないでください。複数選択質問では、カンマ区切りの数字を受け入れてください (例: 1, 3)。

compound-engineering の対話的セットアップ — 環境の健全性を診断し、古いリポジトリローカル CE 設定をクリーンアップし、必要なツールの設定を支援します。レビューエージェントの選択は ce-code-review によって自動的に処理されます。プロジェクト固有のレビューガイダンスは CLAUDE.md または AGENTS.md に記述してください。

フェーズ 1: 診断

ステップ 1: プラグインバージョンを確認

プラグインメタデータまたはマニフェストを読み込んで、インストール済みの compound-engineering プラグインバージョンを検出します。これはプラットフォーム固有です — 利用可能なメカニズムを使用してください (例: プラグインルートまたはキャッシュディレクトリから plugin.json を読み込む)。バージョンが判定できない場合は、このステップをスキップしてください。

バージョンが見つかった場合は、--version フラグ経由でチェックスクリプトに渡してください。それ以外の場合はフラグを省略してください。

ステップ 2: ヘルスチェックスクリプトを実行

スクリプトを実行する前に以下を表示してください: "Compound Engineering -- checking your environment..."

バンドルされたチェックスクリプトを実行してください。手動で依存関係をチェックしないでください — スクリプトが 1 回のパスで全ての CLI ツール、エージェントスキル、リポジトリローカル CE ファイルチェック、.gitignore ガイダンスを処理します。

bash scripts/check-health --version VERSION

またはステップ 1 でバージョンが判定できない場合:

bash scripts/check-health

スクリプトリファレンス: scripts/check-health

スクリプトの出力をユーザーに表示してください。

ステップ 3: 結果を評価

プラグインルート (事前解決): !echo "${CLAUDE_PLUGIN_ROOT}"

上の行が絶対パス (/ で始まり ${ を含まない) に解決された場合、これは Claude Code セッションであり /ce-update が利用可能です。その他の場合 — 空、リテラル ${CLAUDE_PLUGIN_ROOT} トークン、またはブロッキング記号 ! を処理しない非 Claude ハーネスによって残された解決されていないコマンド文字列 — は Claude Code ではないことを意味します。出力から /ce-update への参照を省略してください。

診断レポートの後、以下をチェックしてください:

• CLI ツールが欠落していないか (ツールセクションで黄色で報告される)
• エージェントスキルが欠落していないか (スキルセクションで黄色で報告される)
• compound-engineering.local.md が存在し、クリーンアップが必要でないか
• .compound-engineering/config.local.yaml が存在しないか、安全に gitignore されていないか
• .compound-engineering/config.local.example.yaml が欠落していないか、古くないか

すべてがインストールされ、リポジトリローカルクリーンアップが不要で、.compound-engineering/config.local.yaml が既に存在して gitignore されている場合は、ツールおよびスキルリストと完了メッセージを表示してください。スクリプト出力からツールおよびスキル名を解析し、それぞれを緑色の円で一覧表示してください。スクリプト出力にスキルセクションがない場合はスキルラインを省略してください:

 ✅ Compound Engineering setup complete

    Tools:  🟢 agent-browser  🟢 gh  🟢 jq  🟢 vhs  🟢 silicon  🟢 ffmpeg  🟢 ast-grep
    Skills: 🟢 ast-grep
    Config: ✅

    Run /ce-setup anytime to re-check.

これが Claude Code セッションの場合 (上記の Plugin root が空でないパスに解決された場合)、メッセージに追記してください: "Run /ce-update to grab the latest plugin version."

ここで停止してください。

それ以外の場合、フェーズ 2 に進んで問題を解決してください。リポジトリローカルクリーンアップ (ステップ 4) を最初に処理し、次に設定のブートストラップ (ステップ 5)、次に欠落している依存関係 (ステップ 6) を処理してください。

フェーズ 2: 修正

ステップ 4: リポジトリローカル CE の問題を解決

リポジトリルート (git rev-parse --show-toplevel) を解決してください。compound-engineering.local.md がリポジトリルートに存在する場合、レビューエージェント選択が自動であり CE が機械ローカル状態の生き残りについて .compound-engineering/config.local.yaml を使用するようになったため、それは廃止されていることを説明してください。今すぐ削除するかどうかをユーザーに尋ねてください。削除時にはリポジトリルートパスを使用してください。

ステップ 5: プロジェクト設定をブートストラップ

リポジトリルート (git rev-parse --show-toplevel) を解決してください。以下のすべてのパスは、現在の作業ディレクトリではなく、リポジトリルートからの相対パスです。

例ファイル (常に更新): references/config-template.yaml を <repo-root>/.compound-engineering/config.local.example.yaml にコピーしてください。必要に応じてディレクトリを作成してください。このファイルはリポジトリにコミットされ、常に最新テンプレートで上書きされるため、チームメイトが利用可能な設定を確認できます。

ローカル設定 (1 回のみ作成): .compound-engineering/config.local.yaml が存在しない場合、作成するかどうかを尋ねてください:

Set up a local config file for this project?
This saves your Compound Engineering preferences (like which tools to use and how workflows behave).
Everything starts commented out -- you only enable what you need.

1. Yes, create it (Recommended)
2. No thanks

ユーザーが承認した場合、references/config-template.yaml を <repo-root>/.compound-engineering/config.local.yaml にコピーしてください。.compound-engineering/config.local.yaml がまだ .gitignore でカバーされていない場合、エントリを追加することを提案してください:

.compound-engineering/*.local.yaml

ローカル設定が既に存在する場合、それが安全に gitignore されているかをチェックしてください。そうでない場合は、上記の .gitignore エントリを追加することを提案してください。

ステップ 6: インストールを提案

複数選択質問を使用して、欠落しているツールおよびスキルを提示し、すべてのアイテムを事前選択してください。スクリプトの診断出力からインストールコマンドおよび URL を使用してください。ユーザーが各ランタイムがどのアイテムをターゲットとするか確認できるように、アイテムを Tools: と Skills: の下にグループ化してください。すべてのアイテムがインストールされているグループを省略してください。

The following items are missing. Select which to install:
(All items are pre-selected)

Tools:
  [x] agent-browser - Browser automation for testing and screenshots
  [x] gh - GitHub CLI for issues and PRs
  [x] jq - JSON processor
  [x] vhs (charmbracelet/vhs) - Create GIFs from CLI output
  [x] silicon (Aloxaf/silicon) - Generate code screenshots
  [x] ffmpeg - Video processing for feature demos
  [x] ast-grep - Structural code search using AST patterns

Skills:
  [x] ast-grep - Agent skill for structural code search with ast-grep

実際に欠落しているアイテムのみを表示してください。インストール済みのものは省略してください。

ステップ 7: 選択した依存関係をインストール

選択された各依存関係について、順番に:

1. インストールコマンドを表示 (診断出力から) し、承認を求めてください:

   Install agent-browser?
   Command: CI=true npm install -g agent-browser --no-audit --no-fund --loglevel=error && agent-browser install && npx skills add https://github.com/vercel-labs/agent-browser --skill agent-browser -g -y
   
   1. Run this command
   2. Skip - I'll install it manually
   

2. 承認された場合: シェル実行ツールを使用してインストールコマンドを実行してください。コマンドが完了した後、インストールを確認してください:

   • CLI ツールの場合、依存関係のチェックコマンドを実行してください (例: command -v agent-browser)。
   • エージェントスキルの場合、npx が利用可能な場合は npx --yes skills list --global --json | jq -r '.[].name' | grep -qx <skill-name> を優先してください。それ以外の場合は、~/.claude/skills/<skill-name>、~/.agents/skills/<skill-name>、または ~/.codex/skills/<skill-name> が存在する (ファイル、ディレクトリ、またはシンボリックリンク) ことをチェックしてフォールバックしてください。

3. 確認が成功した場合: 成功を報告してください。

4. 確認が失敗するか、インストールがエラーになった場合: プロジェクト URL をフォールバックとして表示し、次の依存関係に続行してください。

ステップ 8: サマリー

簡潔なサマリーを表示してください:

 ✅ Compound Engineering setup complete

    Installed: agent-browser, gh, jq
    Skipped:   rtk

    Run /ce-setup anytime to re-check.

これが Claude Code セッションの場合 (ステップ 3 のプラットフォーム検出による)、以下を追記してください: "Run /ce-update to grab the latest plugin version."