| name | chief-retro |
| description | Run a retrospective on the current milestone or latest batch. Checks goal/contract coverage, summarizes planned vs delivered, and proposes rule updates. Use "/chief-retro" after completing a batch or milestone. |
Run a retrospective on the current milestone.
Scope Detection
Auto-detect the scope:
- Read
_plan/_todo.md in the active milestone.
- If ALL tasks are marked
[x] → milestone retro.
- If some tasks remain → batch retro (covers only the latest completed batch).
Input Sources
Batch retro
- Latest
_report/autopilot-run-batch-<N>.md
_plan/_todo.md (completed vs remaining)
_goal/ and _contract/ files
git log for commits since the previous batch report (or milestone start)
Milestone retro
- ALL
_report/ files (batch reports, task outputs, etc.)
_plan/_todo.md (full history)
_goal/ and _contract/ files
git log for the entire milestone
Report Sections
Write the report with these sections:
# 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
Output File
- Batch retro →
.chief/<milestone>/_report/retro-batch-<N>.md
- Milestone retro →
.chief/<milestone>/_report/retro-milestone.md
Where <N> matches the batch number being reviewed.
After Report
Present the proposed rule updates to the user. Ask:
"Want me to apply any of these rule proposals?"
- User picks which ones to apply.
- For each approved proposal, create or update the file in
.chief/_rules/.
- For rejected proposals, leave them in the report only.
Rules
- NEVER skip the coverage check — this is the primary value of the retro.
- NEVER auto-apply rule proposals — always ask first.
- NEVER modify goals, contracts, or plans — retro is read-only on those. Only
_rules/ can be updated.
- Use actual git log and file content — do not summarize from memory.
- Follow the rules hierarchy: AGENTS.md > .chief/_rules > milestone goals.