chief-loop について
chief-loopは、目標と契約が満たされるまでchief-agentでマイルストーンを進める自動モードのスキルです。3~5件ずつタスクを処理し、実装をbuilder-agentに委任して、各タスクの判断を個別に記録します。
主な機能
- 01タスクバッチによるマイルストーン進行
- 02builder-agentへの実装委任
- 03目標と契約の達成確認
- 04タスクごとの判断レポート
- 05選択肢の提示による曖昧さへの対応
活用シーン
- 01連続するタスクバッチでマイルストーンを進行
- 02各タスクの結果と判断を記録
- 03人への確認で停止せずタスクの曖昧さに対応
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ thaitype/ chief --skill chief-loopインストール後、Claude Code で/chief-loopを入力して読み込まれたか確認します。
詳細
目標と契約の両方が満たされるまで、バッチを重ねながらマイルストーン全体で chief-agent を実行し、バッチごとにレポートを1つまとめるのではなく、各タスクについて判断の経緯を記録したレポートを作成します。
これは chief-autopilot の自動モードを直接拡張したものです。「曖昧な点があれば停止して人間に確認する」動作を希望する場合は、代わりに chief-autopilot safe を使用してください。chief-loop は自動モードでのみ実行され、安全モードに相当するものはありません。
前提条件の確認
作業を始める前に、次のことを確認します。
.chief/配下でアクティブなマイルストーンディレクトリを特定します。_goal/に空でないファイルが少なくとも1つあることを確認します。_contract/に空でないファイルが少なくとも1つあることを確認します。
いずれかが存在しない場合 → 停止します。ユーザーに次のように伝えます。
"chief-loop の実行には目標と契約が必要です。まず
/chief-planを実行してください。"
続行してはいけません。
開始前の確認
現在の目標と契約を簡潔にまとめてユーザーに提示します(ファイル名と、それぞれの1行の説明)。
次の質問を1つします。
"目標と契約はこれで正しいですか?chief-loop を実行しますか?それとも、先に
/chief-planを使って修正しますか?"
ユーザーが修正すると答えた場合 → 停止します。 ユーザーが続行を確認した場合 → 続行します。
任意: loop-readiness スキルを利用できる場合は、続行する前に、このマイルストーンの計画に対して実行するかどうかを提案します。このスキルは、計画に無人で安全に実行するためのフィードフォワード/フィードバックのカバレッジが十分にあるかを確認します。計画が依存する既存のゲートがあると指摘された場合は、それらを実際に実行して引き続き合格することを確認する loop-preflight も提案します。どちらも提案であり、必須ではありません。ユーザーが辞退した場合は、それらを実行せずに続行します。
外側のループ(必要な数のバッチを実行)
1. TODO の作成または更新
既存の _plan/_todo.md があれば読み込みます。目標、契約、完了済みの作業に基づいて、次のバッチとして3〜5個のタスクを作成します。chief-autopilot と同じ、小さなバッチで進める原則を守ります。
_plan/_todo.md に書き込みます。承認を待ってはいけません。これはオートパイロット形式であり、計画レビューのために一時停止しません。
2. バッチ内の作業をタスクごとに進める
現在のバッチにある未完了のタスクごとに、次の手順を実行します。
- 次の情報を添えて builder-agent に委任します。
- TODO の項目
- マイルストーンの目標(
_goal/) - マイルストーンの契約(
_contract/) - 関連する全体ルール(
.chief/_rules/) - 検証時の要件
- builder の完了を待ちます。
- builder が阻害要因または曖昧さを報告した場合は、次に進む前に、以下の曖昧さへの対応を確認します。
_todo.mdでタスクを[x]にします。- そのタスクのレポートを作成します(以下のタスクレポートを参照)。これは、次のタスクを始める前に直ちに行います。レポートの作成をバッチの最後までまとめて先送りしてはいけません。
3. マイルストーンの完了を確認
バッチの作業がすべて完了したら、次のようにします。
- 目標がすべて達成されていない場合、または実装がまだ契約を満たしていない場合 → 手順1に戻り、次のバッチを作成します。
- 目標と契約の両方が満たされている場合 → 停止します。マイルストーンは完了です。
バッチ数に上限はありません。両方の条件が満たされるまで続けます。
曖昧さへの対応
builder-agent がタスクの阻害要因または曖昧さを報告した場合:
- 使い捨てエージェント(永続的なエージェントタイプではなく、通常の
Agentツール呼び出し)を起動し、自己完結したプロンプトを渡します。曖昧な点、把握している選択肢を説明し、それぞれ1行のトレードオフを添えた具体的な選択肢を2〜3個提案するよう依頼します。このエージェントの役割は選択肢の検討を支援することだけです。判断を下したり、ファイルを書き込んだりしてはいけません。 - chief-agent が提案された選択肢を確認し、自ら1つを選択します。
chief-autopilotと同様、常に chief-agent が最終決定者です。 - 問題点、検討した選択肢、選択した内容とその理由を、そのタスクのレポートに記録します(以下を参照)。
タスクに曖昧さがない場合は、このセクション全体を省略します。エージェントは起動せず、タスクのレポートは簡潔で事実に基づく要約のみとします。
タスクレポート
曖昧さのあるタスクだけでなく、すべてのタスクについて、次のファイルを作成します。
.chief/<milestone>/_report/task-<task-id>-report.md
<task-id>には、_plan/task-<task-id>.mdと同じ値を使用し、2つのファイルが1対1で対応するようにします。
# Task <task-id> Report
## Task
One or two lines on what this task was.
## Outcome
done | blocked
## Decision
(Omit this whole section if the task had no ambiguity.)
- **Issue:** what was ambiguous or blocking
- **Options considered:** the options the decision-support agent proposed
- **Chosen:** which one, and why
## Notes
Anything worth carrying into the next task or batch.
ルール
- 目標とコントラクトが存在しない状態で、絶対に開始しないでください。
- エントリー確認を絶対に省略しないでください。
- 曖昧さについて人間からの入力を待つために、絶対に停止しないでください。このスキルの動作は、オートモードのようなものに限られます。確認のために停止したい場合は、ユーザーに
chief-autopilot safeを案内してください。 - 曖昧さについて最終決定を下すのは、常に chief-agent です。意思決定支援エージェントは選択肢を提案するだけで、決定もファイルの作成も行いません。
- すべてのタスクについて、完了後すぐにレポートを作成してください。レポートの作成をまとめて後回しにしてはいけません。
- 小さなバッチの原則(TODO サイクルあたり3~5タスク)を守ってください。変更されたのはレポートの粒度だけであり、計画のペースではありません。
- マイルストーンの完了には、目標の達成とコントラクトの充足の両方が必要です。目標を達成しただけでは、停止できません。
- すべての実装は Builder-agent が担当します。Chief は絶対にコードを書きません。
- ユーザーが明示的に依頼しない限り、Tester-agent は使用しません。