chief-install

現在のプロジェクトにChiefフレームワークをインストールします。

これは遅延インストールです。インストール時に配置されるのはサブエージェントとAGENTS.mdのみです。.chief/（project.md、マイルストーン、ルール）はchief-agentによって必要に応じて作成されます。/chief-initを実行してプロジェクトのコンテキストを初期化するか、そのまま/chief-planを開始してください。

引数

最初の引数は対象バージョン（ブランチまたはタグ）です。省略可能です。

• 引数なし → 最新の安定版リリース（semverタグのうち最も新しいもの）をインストールします。git ls-remote --tags https://github.com/thaitype/chief.gitを実行して確認し、refs/tags/を削除し、^{}のエントリを除外して、最も大きいsemverバージョンを選びます。
• canary → 最新のcanaryブランチ（開発中、未リリース）
• v1.0.0、v2.0.0など → 指定したタグのバージョン

手順

1. 既存のインストールを確認する

次の兆候を確認して、Chiefがすでにインストールされているか確認します。

1. .agents/agents/chief-agent.mdが存在する
2. ルートにあるAGENTS.mdに「Chief」または「chief-agent」というキーワードが含まれている（ファイルの内容を確認してください。ファイルが存在するだけでは不十分です。別のセットアップによって作成されている場合があります）

いずれかに該当する場合 → フレームワークはすでにインストールされている可能性があります。ユーザーに警告し、アップグレードを提案してください。次の内容を表示します。

npx skills@latest add thaitype/chief --skill chief-upgrade
/chief-upgrade

ユーザーが新規インストールを明示的に希望しない限り、続行しないでください。

どちらにも該当しない場合 → 続行します。

2. コーディングエージェントとインストールモードを尋ねる

ユーザーに次の項目を尋ねます。

1. どのコーディングエージェントを使いますか？ — 対応エージェント：claude-code、opencode、codex、cursor、copilot、gemini-cli、amp、windsurf、kiro、aider
2. インストールモードはどちらですか？（claude-codeおよびcopilotの場合に関係します）
   • link（推奨） — エージェント固有のディレクトリから.agents/へのシンボリックリンクを作成します
   • copy — シンボリックリンクの代わりにファイルをコピーします
   • Windowsでは、linkモードを使うには開発者モードを有効にし、git config --global core.symlinks trueを設定する必要があります。利用できない場合は、copyモードを提案してください。
   • それ以外のすべてのエージェントでは、AGENTS.mdと.agents/を直接読み込むため、モードによる動作の違いはありません

3. クローンしてセットアップスクリプトを実行する

git clone --depth 1 --branch <version> https://github.com/thaitype/chief.git .chief-agent-tmp
bash .chief-agent-tmp/scripts/setup.sh --agent <agent> --mode <mode>

スクリプトによって、次のものがインストールされます。

• .agents/agents/*.md — サブエージェントの定義（chief、builder、tester、review-plan）
• AGENTS.md — フレームワークのルール（存在しない場合は新規作成。すでにAGENTS.mdがある場合は、``ブロック内に追記）
• エージェント固有の統合ファイル（.claude/agents/、.github/agents/）（claude-code／copilot用）

.chief/は作成されません。これは意図した動作です。

セットアップスクリプトが完全に失敗した場合（終了コードが0以外、またはクラッシュした場合）は、手動で完全インストールを行うため、手順3bに進んでください。まだrm -rf .chief-agent-tmpを実行しないでください。手動での作業に必要です。

セットアップスクリプトが成功した場合は、手順4に進みます。

3b. 手動で完全インストールする（セットアップスクリプトが失敗した場合の代替手順）

セットアップスクリプトが失敗した場合は、すべてのインストール作業を手動で行います。

# Subagent definitions (canonical)
cp -r .chief-agent-tmp/template/.agents .agents

AGENTS.mdをインストールします（新規作成または追記）：

if [ ! -f AGENTS.md ]; then
  cp .chief-agent-tmp/template/AGENTS.md AGENTS.md
elif ! grep -qF "" AGENTS.md; then
  {
    echo ""
    echo ""
    cat .chief-agent-tmp/template/AGENTS.md
    echo ""
  } >> AGENTS.md
fi

claude-codeの場合のみ、Claude Codeとの統合をセットアップします。

linkモード：

ln -s AGENTS.md CLAUDE.md
mkdir -p .claude/agents
for f in .agents/agents/*.md; do ln -s "../../$f" ".claude/agents/$(basename "$f")"; done

copyモード：

cp AGENTS.md CLAUDE.md
mkdir -p .claude/agents
cp .agents/agents/*.md .claude/agents/

copilotの場合のみ、GitHub Copilotとの統合をセットアップします。

linkモード：

mkdir -p .github/agents
for f in .agents/agents/*.md; do ln -s "../../$f" ".github/agents/$(basename "$f")"; done

copyモード：

mkdir -p .github/agents
cp .agents/agents/*.md .github/agents/

それ以外のエージェントでは、追加の手順は不要です。

claude-code以外のエージェントの場合は、ユーザーにモデル名を尋ねます。

1. 思考モデル（chief-agent用。例：o3、gemini-2.5-pro）
2. コーディングモデル（builder／tester／review-plan用。例：gpt-4.1、gemini-2.5-flash）

chief-agent内の${thinking_model}を思考モデルに置き換え、その他すべてのエージェントファイル内の${coding_model}をコーディングモデルに置き換えます。claude-codeの場合は、プロンプトを表示せずにopusとsonnetに自動置換します。copilotの場合は、.github/agents/内のファイルを更新します。それ以外のエージェントの場合は、.agents/agents/内のファイルを更新します。

すでに存在するファイルはスキップし、ユーザーに警告してください。

4. インストールを検証する

セットアップスクリプトまたは手動インストールが完了したら、次の項目を検証します。

1. サブエージェントのファイルが存在すること：

   • .agents/agents/chief-agent.md
   • .agents/agents/builder-agent.md
   • .agents/agents/tester-agent.md
   • .agents/agents/answer-verifier-agent.md

   review-plan-agent.md は非推奨であり、新しいプロジェクトにはインストールされません。ローカルに残っている既存のインストールでは、アップグレード時にそのまま残します。

2. AGENTS.md が存在し、chief フレームワークの内容（ファイル全体、または `` ブロック）が含まれていること。

3. Claude Code のみ（エージェントが claude-code の場合）：

   • CLAUDE.md が存在すること（モードに応じてシンボリックリンクまたはコピー）
   • .claude/agents/ に 4 つすべてのエージェントのエントリーがあること
   • リンクモードの場合：シンボリックリンクが正しく解決されることを確認する

4. Copilot のみ（エージェントが copilot の場合）：

   • .github/agents/ に 4 つすべてのエージェントのエントリーがあること（モードに応じてシンボリックリンクまたはコピー）
   • リンクモードの場合：シンボリックリンクが正しく解決されることを確認する
   • ユーザーがモデル名を指定した場合、モデルの値が置き換えられていること

インストール後に .chief/ が存在する必要はありません。存在しないことを問題として指摘しないでください。

5. 問題を修正する（フォールバック）

検証項目のいずれかに失敗した場合は、手動で修正します。

• サブエージェントのファイルがない → .chief-agent-tmp/template/.agents/agents/ がまだ存在する場合はそこからコピーし、存在しない場合は再度クローンして該当ファイルをコピーする
• AGENTS.md がない → 3b の Fresh-or-Append スニペットを再実行する
• CLAUDE.md がない → シンボリックリンク（ln -s AGENTS.md CLAUDE.md）を作成するか、モードに応じてコピーする
• .claude/ のシンボリックリンクがない → 個別に作成する：

  mkdir -p .claude/agents
  ln -s ../../.agents/agents/<file>.md .claude/agents/<file>.md
  

• シンボリックリンクが壊れている → 削除して再作成する
• モードが違う（例：ユーザーはリンクを希望したのにコピーになっている）→ 削除し、正しいモードで再作成する

6. クリーンアップ

.chief-agent-tmp が削除されていることを確認します：

rm -rf .chief-agent-tmp

7. 次のステップ

ユーザーに次の内容を伝えます。

1. /chief-init を実行して、技術スタックと開発コマンドを設定した .chief/project.md を初期化する
2. AGENTS.md を確認し、必要に応じてカスタマイズする
3. 計画を開始する：/chief-plan（または chief-agent に直接依頼する）

.chief/ とそのサブフォルダーは、作業に応じて自動的に作成されます。マイルストーンフォルダー、ルールのサブフォルダー、レポートは、必要になった時点で初めて書き込まれます。

重要なルール

• ユーザーの明示的な承認なしに既存ファイルを上書きしないでください
• AGENTS.md がすでに存在し、内容が含まれている場合は、chief ブロックを追記してください。上書きしてはいけません
• フレームワークがすでにインストールされている場合は、代わりに /chief-upgrade を提案してください
• インストールがキャンセルまたは失敗した場合も、必ず .chief-agent-tmp を削除してください
• セットアップスクリプトが失敗した場合は、断念する前に手動での修正を試みてください
• インストール時に .chief/ を作成しないでください。現在は遅延作成されます
• 成功した項目も含め、すべての検証結果をユーザーに報告してください