chief-retro について
chief-retroは、マイルストーンの目標と契約に照らして完了作業を確認し、バッチまたはマイルストーンの振り返りレポートを作成します。プロジェクトのレポートとGit履歴を参照し、ルール変更案はユーザーの承認後に適用します。
主な機能
- 01バッチまたはマイルストーンの範囲判定
- 02目標と契約の達成状況確認
- 03レポートとGit履歴の確認
- 04振り返りレポートの作成
- 05ルール更新に承認を要求
活用シーン
- 01完了したタスクバッチの振り返り
- 02マイルストーン全体の達成状況の評価
- 03振り返りからルール変更案を提示
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ thaitype/ chief --skill chief-retroインストール後、Claude Code で/chief-retroを入力して読み込まれたか確認します。
詳細
現在のマイルストーンの振り返りを実施します。
対象範囲の判定
対象範囲を自動的に判定します。
- アクティブなマイルストーンの
_plan/_todo.mdを読みます。 - すべてのタスクに
[x]が付いている場合 → マイルストーンの振り返り。 - 未完了のタスクがある場合 → バッチの振り返り(直近の完了済みバッチのみを対象とします)。
入力ソース
バッチの振り返り
- 最新の
_report/autopilot-run-batch-<N>.md _plan/_todo.md(完了済みタスクと未完了タスク)_goal/および_contract/のファイル- 前回のバッチレポート(またはマイルストーン開始)以降のコミットを示す
git log
マイルストーンの振り返り
- すべての
_report/ファイル(バッチレポート、タスクの出力など) _plan/_todo.md(全履歴)_goal/および_contract/のファイル- マイルストーン全体の
git log
レポートのセクション
以下のセクションでレポートを作成します。
# Retro: <milestone> — <batch N | milestone>
## Coverage Check
For each goal and contract file, check whether the work done satisfies it:
| File | Status | Notes |
|------|--------|-------|
| _goal/xxx.md | ✅ Satisfied / ⚠️ Partial / ❌ Missing | what's done or missing |
| _contract/xxx.md | ✅ / ⚠️ / ❌ | ... |
## Planned vs Delivered
- What was in the TODO
- What was actually completed
- What was skipped or changed mid-execution
## Blockers Hit
- Issues encountered during execution
- How they were resolved (or not)
## Lessons Learned
- Patterns observed (good and bad)
- Recurring problems
- Surprises or unexpected outcomes
- What worked well and should be repeated
## Proposed Rule Updates
For each proposal:
- **What:** the rule to add or change
- **Where:** which file in `.chief/_rules/` (e.g. `_standard/auth.md`, `_verification/tests.md`)
- **Why:** what happened that motivates this rule
- **Suggestion:** recommended for the user
## User Action Needed
Items requiring human decision:
- Uncovered goals or contracts that need another batch
- Decisions to promote to permanent rules
- Manual steps that automation couldn't handle
出力ファイル
- バッチの振り返り →
.chief/<milestone>/_report/retro-batch-<N>.md - マイルストーンの振り返り →
.chief/<milestone>/_report/retro-milestone.md
<N> には、振り返りの対象となるバッチ番号を指定します。
レポート作成後
ルールの更新案をユーザーに提示します。次のように尋ねます。
「このルール案を適用しますか?」
- ユーザーが適用する案を選びます。
- 承認された案ごとに、
.chief/_rules/内のファイルを作成または更新します。 - 却下された案は、レポートにのみ残します。
ルール
- カバレッジチェックを絶対に省略しないでください。これが振り返りの主な価値です。
- ルールの更新案を絶対に自動適用しないでください。必ず先にユーザーに確認してください。
- ゴール、コントラクト、計画は絶対に変更しないでください。振り返りではこれらを読み取り専用とし、更新できるのは
_rules/のみです。 - 実際の
git logとファイルの内容を使用してください。記憶をもとに要約してはいけません。 - ルールの優先順位に従ってください:AGENTS.md > .chief/_rules > マイルストーンのゴール。
コメント
Markdown 対応