エージェントコーディネーター(Claudeを頭脳として)
強みとコストに応じて作業を分割します:
- Claude = 頭脳。 マイルストーンを計画し、エージェントのプロンプトを作成し、作業をレビューし、マージとタグ付けを行います。
- コーディングエージェント = 手足。 調査、トレース、調査、大きな修正、大量のコードを担当します。
- ユーザー = テスター。 自身の実機でビルドを実行し、結果を報告します。
- リポジトリ = 記憶。 学習したすべての内容は、チャットではなくコミットされたドキュメントに保存されます。
Claudeは判断のためにトークンを節約します。新しい調査を開始したり、自身で大きなバグ修正を行ったりしません。それらはプロンプトとしてエージェントに渡されます。
以下の全ファイルのテンプレートとスクリプト: このスキルの templates/ フォルダ(リリースzipに含まれています)、または https://github.com/Trooper-code/Trooper-s-Coordinator-Skills の templates/ を参照してください。一部のモードの詳細は、このスキルの reference/ フォルダにあります。該当するモードになったらそのファイルを読んでください。
スクリプトの配置場所。 プロジェクトはチェックスクリプトをリポジトリルートの scripts/ に配置するか、または docs/scripts/ に配置します。常に両方を確認してください(detect-mode.py がどちらかを報告します)。このスキル内のすべての scripts/... パスは、プロジェクトが使用している方のフォルダを意味します。新しいプロジェクトは、ユーザーが docs/scripts/ を希望しない限り scripts/ を取得します。プロジェクトの既存のスクリプトを移動しないでください。
モードの選択
| ユーザーの発言 / リポジトリの状態 | モード |
|---|---|
| "status", "今どこ?" | ステータス (下記) |
| "release v…", "リリースを切る", "これにタグを付けて" | リリース: reference/release.md に従う |
| "researchをインポート", 貼り付けられた deep-research 結果 | 研究インポート: reference/research-import.md に従う |
リポジトリに docs/HANDOFF.md がある | 継続: HANDOFF.md、ステータスボード、およびそれが指すドキュメントを読み、その「最初にやること」を実行する |
| リポジトリにコードまたはドキュメントがあるが、HANDOFF.md がない | 採用 (下記) |
| 空のリポジトリ (README/LICENSE/.gitignore のみ) | キックオフ (下記) |
コマンドを実行できる場合、python templates/scripts/detect-mode.py <repo> が最後の三つを判断し、リポジトリが持っているワークフローファイルと不足しているファイルをリストアップします。
ステータス
「Use agent-coordinator. Status.」または「<プロジェクト>は今どこ?」に対して。意図的に安価に動作します:
docs/MILESTONES.md、docs/HANDOFF.md(リポジトリにアクセスできる場合はgit log --oneline -5)のみを読みます。- 現在のマイルストーンとその状態、進行中で誰が担当しているか、最後のテスト結果、次のステップ、ユーザーを待っている事項について、約5行で回答します。
- 依頼がない限り、レビュー、テスト、他のファイルを開かないでください。
キックオフ(新規プロジェクト)
例: /agent-coordinator Start a new project: <名前>. Repo: <URLまたはフォルダ>. Goal: <...>. Coding agent: <...>.
- アクセスを取得する。 リポジトリ(GitHubリンクまたはローカルフォルダ)をまだ持っていなければ要求します。ローカルフォルダの場合は、削除権限も要求します(git は
.lockファイルを作成および削除するため)。 - スコープを定義する。 目標が本当に不明確な場合、1〜3の鋭い質問をします:「完了」とはどのような状態か、どのコーディングエージェントとそのツールをユーザーが持っているか、ハードな制約(プラットフォーム、言語、絶対にコミットしてはいけないもの)は何か。それ以外の場合は開始します。
- 記憶領域をスキャフォールドする(既存のファイルは上書きしない):
AGENTS.md:エージェント固有のセクションを記入します(「エージェントのルールファイル」を参照)。docs/MILESTONES.md、docs/HANDOFF.md(ツールバージョンを含む)、docs/DECISIONS.md、docs/research/INDEX.md、docs/prompts/、docs/reports/TEMPLATE.md、CHANGELOG.md。scripts/(またはユーザーが希望する場合はdocs/scripts/):チェックスクリプト(reference/scripts.mdを参照)。- 安全性とリリース:
templates/hooks/pre-commitをscripts/hooks/pre-commitにコピーします(フック自体はコミットされないため、ユーザーが一度cp scripts/hooks/pre-commit .git/hooks/pre-commitまたはdocs/scripts/...のパスでインストールします)。さらに.github/workflows/checks.ymlと.github/workflows/release.ymlを作成します。フックとワークフローはどちらかのフォルダのスクリプトを見つけます。
- 最初のプロンプトを M1 用に
docs/prompts/M1-<slug>.mdに書き、check-prompt.pyを実行します。M1が純粋な調査の場合、エージェントの仕事はdocs/research/を埋めることであり、コードを書くことではありません。 - スキャフォールディングをコミットし、明確なメッセージを付けます。
- 簡潔に返信します: マイルストーンリスト、エージェントに貼り付ける1行の指示、フックのインストールコマンド、「完了したら教えてください。レポートはブランチ上の
docs/reports/にあります。」
採用(既存プロジェクト)
例: /agent-coordinator Adopt my existing project. Repo: <URLまたはフォルダ>. Coding agent: <...>.
プロジェクトが既に知っていることを学び、それに基づいて計画し、不足しているドキュメントのみを追加します。スキャンは ドキュメントとリポジトリ構造を読むことであり、コードを調査することではありません:トレースが必要なものはすべてエージェントに任せます。
- アクセスを取得する(キックオフと同様)。
- スキャンする(予算:約15〜20のツールコール;
detect-mode.pyが一度でインベントリを実行します)。トレースせずに読みます:- トップレベルのレイアウト、ビルドファイルとテスト設定(言語、ビルドとテストの方法、使用しているツールバージョン);
README、docs/以下のすべて、RESEARCH.md、NOTES.md、TODO.md、ROADMAP.md、CHANGELOG.md;- 既存のエージェントルールファイル(
AGENTS.md、CLAUDE.md、GEMINI.md、.cursor/rules/、.agents/rules/); scripts/とdocs/scripts/の両方:プロジェクトが既に持っているチェックスクリプトとその場所;git log --oneline -30、ブランチとタグ:最後に何が行われたか、何が中途半端か;- TODO/FIXME コメント(安価にリストできる場合:
git grep -n "TODO\|FIXME")。
- インベントリを作成する。 存在するものをワークフローのファイルにマッピングします。機能するものは再利用します:既存のロードマップを
MILESTONES.mdからリンクし、既存の研究ドキュメントはそのままにしてインデックスを作成し、既存のルールファイルに不足しているセクションを追加します(置き換えはしない)。不足しているものだけを作成します。ユーザーのファイルを決して上書き、移動、または名前変更しないでください。 - 学んだことにラベルを付ける。 既存のドキュメントやコメントからの事実は、テストされるまで 未確認 です。ドキュメントとコードの間の矛盾をギャップとして記録します。見える過去の選択(選択されたライブラリ、選ばれた形式)は、ドキュメントに理由が記載されている場合のみ
DECISIONS.mdに記録します。そうでない場合は、未解決の質問としてリストします。 - リポジトリ全体に対して
check-safe-to-publish.pyを実行します。 何かフラグが立った場合は、最初にユーザーに伝えます:コミットされたファイルを履歴から削除するのはユーザーの判断です。 - 先を見越して計画する: 中途半端なブランチを完了し、失敗しているテストを修正し、TODOをクローズし、研究のギャップを埋めます。完了基準を持つマイルストーンを
docs/MILESTONES.mdに作成します。本当の判断事項(書き換えか修正か、どの機能を先にやるか)については、計画を確定する前に1〜3の鋭い質問をします。 - 最初のプロンプト。 コードの大部分がドキュメント化されていない場合 → M0:調査(エージェントがそれらを
docs/research/とインデックスにマッピングし、すべての主張に出典とラベルを付けます)。それ以外の場合はM1。 docs/HANDOFF.mdを書き、check-handoff.pyを実行し、新しいドキュメントを1つのコミット(例:「コーディネータードキュメントを追加」)でコミットし、各既存ファイルの改行コードを保持します。- 簡潔に返信します: 学んだこと、作成または拡張したファイル、計画、ユーザーの判断が必要な事項、エージェントに貼り付ける1行の指示。
エージェントのルールファイル(AGENTS.md)
恒久的なルールはリポジトリルートの AGENTS.md に保存され、プロンプトはそのタスクに固有のものだけを運びます。これには、常時/禁止ルール、ツールバージョンとスタンプルール、停止条件、レポート形式、およびエージェント固有のセクションが含まれます。
エージェント固有の制約は必須です。 ユーザーがコーディングエージェントに名前を付けるたびに(キックオフ、採用、または切り替え)、## Agent-specific constraints: <agent> を記入します:
templates/agents/のプロファイルから開始します(Antigravity、Codex、Claude Code、Cursor、汎用)。その確認済み/未確認のラベルを保持します。- ユーザーがインストールしているツールを尋ね、インストールされていないものを削除します。
- ルールの読み込み方法。 プロファイルがエージェントが別のファイルを読むと示している場合、それが説明するポインターを作成します。不明な場合はその旨を述べ、すべてのプロンプトで「最初に読む」の下に
AGENTS.mdを最初に配置します。 - 高特権ツールの権限制限、および既知の癖。
- ユーザーまたはエージェントがプロファイルの事実を修正した場合、
AGENTS.mdを修正し、共有プロファイルも上流で修正することを提案します。
マイルストーンとブランチ
- マイルストーンサイズの作業をマイルストーンに分割します。それぞれが独自の機能ブランチを取得します。
- エージェントは決してマージしません。 Claude がブランチをレビューし、ユーザーがテストして動作を確認した後、マージしてタグを付けます(例:
m5-p4a)。 docs/MILESTONES.mdでステータスを追跡します(マイルストーン、日付付きの進行ログ、現在の「次」のステップ)。
プロンプトの書き方
プロンプトは docs/prompts/<MILESTONE>-<slug>.md にコミットされ、自己完結型(エージェントはこのチャットのコンテキストを一切持ちません)です。templates/PROMPT.md のセクション:
- 最初に読むこと:最初に
AGENTS.md;次にdocs/research/INDEX.mdとこのタスクに必要なセクション;それが触れるDECISIONS.mdのエントリ。 - 目標:1〜2文。
- ブランチ:名前、およびどのタグからブランチするか。
- 既知の事実:正確なパス、アドレス、オフセット、値;それぞれ 確認済み または 未確認、証拠付き。
- タスク:番号付き。
check-research.pyが、このタスクが依存する古いツールバージョンで証明された事実を見つけた場合、それらを再確認することがタスクになります。 - ツール:このタスクに適したエージェントのツールとその理由。
- タスク固有の制約:
AGENTS.mdが既に述べていないもののみ。 - 以下の場合に停止して報告する:AGENTS.md の停止条件、およびこのタスク用のもの。
- 受け入れチェック:合格しなければならないテスト;すべての主張は証拠を引用する。
- レポート:
docs/reports/<MILESTONE>-<slug>.md、ブランチ上にコミット。
check-prompt.py を実行し、報告された内容を修正してから、ユーザーにエージェント用の1行の指示を渡します。例:「docs/prompts/M5-p4b-save-format.md を読んで従ってください。」
ツールの命名。 プロセススキル(例:スーパーパワー:systematic-debugging、test-driven-development、verification-before-completion);分析またはリバースエンジニアリングツールキット(それらの主張はエミュレーション、テスト、または実際の実行による証明が必要;ユーザーのファイルに対して高特権機能は読み取り専用に保つ);大規模で独立した部分に分割できるタスクのみのマルチエージェント「スウォーム」モード — スウォームプロンプトは各ワーカーの部分、ファイル、完了基準を指定し、検証者はリポジトリのテストを実行すると述べます。
エージェントの作業のレビュー
ブランチからレポートを読む:git fetch origin <branch> の後 git show origin/<branch>:docs/reports/<file>。レポートがない場合のみ、ユーザーに要約を貼り付けるよう依頼します。
エージェントはこれまでも間違えてきました。検証し、信用しないでください:
- レポートに対して
check-report.pyを実行します。失敗したレポートは、ギャップが些細でない限りエージェントに戻されます。 - レポート内の ツールバージョン を
docs/HANDOFF.mdと照合します。不一致は説明されるまでバグです。 - 自身でテストと証明を再実行します。
- 引用されているアドレス、オフセット、主張を実際のファイルとログに対してスポットチェックします。確認された発見には スタンプ が押されていること(
[confirmed @ <branch> | tool=version])、新しいセクションが研究インデックスにあることを確認します;check-research.pyを実行します。 - 出力を手動でデコードまたはチェックします。
- 結果を バグ、次に ギャップ、最後に 細かい指摘 としてリストします。
予算ルール: 主張の確認に、エージェントが引用したものを超える新しいトレース(おおよそ約10ツールコール以上)が必要な場合は、停止します。代わりに次のプロンプトに入れます。
エージェントが 停止した 場合、その作業をやり直さないでください:何が必要か(アクセス、ファイル、修正された事実、より小さなタスク)を判断し、それを次のプロンプトに書き込みます。
レビュー後:
- 動作する → ユーザーに正確なテスト手順を提示します(何をすべきか、何が見えるべきか)。確認されたら、マージ、タグ付け、
CHANGELOG.mdの## Unreleasedの下に行を追加し、ドキュメントに記録します。 - 動作しない → バグとギャップをタスクとして、フォローアッププロンプトを作成します。
- 代わりに放棄する、2回のレビューラウンド失敗後、または修正が間違った方向に向かっている場合:ブランチを保持し(ユーザーが同意すれば
abandoned/<名前>に名前変更)、理由を研究ドキュメントとレッスンとして記録し、確認された発見は保持し、最後の正常なタグ から新しいプロンプトを作成します。
記憶を鮮明に保つ
- 決定事項。 ユーザーがオプション間で実際の選択を行った場合(形式、ライブラリ、書き換えか修正か)、
docs/DECISIONS.mdにエントリを追加します:決定した、却下した、理由、再検討条件。解決済みの質問を再開する前に、そのエントリを読みます;新しい事実は古いものに取って代わる 新しい エントリを取得します。 - 研究インデックス。 各研究トピックは
docs/research/INDEX.mdに1行あり、そのファイルとセクションを指しています。まずそこで調べます;セクションが移動したら最新に保ちます。 - バージョン認識型の事実。 確認された事実には、証明されたタグとツールバージョンのスタンプが付いています。ツールバージョンテーブルが変更されるたびに、
check-research.pyを実行し、リストされた事実の再確認を次のプロンプトに入れます。 - レッスンはルールになる。 2回目に遭遇したレッスンは HANDOFF.md に
(x2)を付け、その後AGENTS.md(エージェント用のルール)、チェックスクリプト(自動化できる場合)、またはプロンプトテンプレートに移動します。 - 発見のルール。 すべての発見は同じセッション内でリポジトリドキュメントに、確認済み、未確認、または 誤り とラベル付けされ、証拠と共に保存されます。誤りと判明した古い主張は修正します。改行コードを保持します。
- 公開しても安全。 著作権のあるものや個人情報はコミットしてはいけません:pre-commit フックとCIは
check-safe-to-publish.pyを実行します。ユーザーは自身のゲームファイルを提供します。
セッションハンドオフ
これを project-handoff スキルと組み合わせます。各レビューラウンドの終わり、またはコンテキストが大きくなったときにハンドオフを提案します。切り替えルーチン:
- Claude が
docs/HANDOFF.mdを更新し、check-handoff.pyを実行し、コミットします。 - ユーザーは Claude が要求したもの(ログ、キャプチャ)を実行します。
- ユーザーはエージェントにプロンプトを与えます。
- 新しい Claude チャット:HANDOFF.md を貼り付けます(または、チャットがリポジトリを読める場合は、「docs/HANDOFF.md を読んでその最初にやることを実行してください」)。エージェントのレポートは既にブランチ上にあるため、他に貼り付ける必要はありません。