Menu
Run a post-session retrospective. Use when the user says "retro", "retrospective", or "what should we update?".
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | retro |
| description | Run a post-session retrospective. Use when the user says "retro", "retrospective", or "what should we update?". |
| argument-hint | |
| user-invocable | true |
| allowed-tools | Read, Grep, Glob, Bash |
| model | sonnet |
Review the current session and propose documentation updates.
Summarize what was accomplished this session
Answer these questions:
Check for documentation updates needed:
CLAUDE.md Domain Knowledge section — any new gotchas to add?docs/LINEAR_SNAPSHOT.md — any bugs to log with /document-bug?docs/CURRENT_SPRINT.md — any progress to record?Report in this format:
## Session Retrospective
### Accomplished
- [what was done]
### Issues Encountered
- [any problems and how they were resolved]
### Proposed Documentation Updates
- [ ] CLAUDE.md: Add gotcha about [X] to Domain Knowledge
- [ ] Linear: Log bug about [Y] with /document-bug
- [ ] CURRENT_SPRINT.md: Update progress on [Z]
- [ ] No updates needed ← (say this if true, don't invent updates)
### Carry Forward
- [anything incomplete for next session]
Pick a bug from Linear, fix it test-first, verify, and update. Use when the user says "fix issue", "fix bug", "work on known issue", or "pick a bug".
Create a new ticket for task tracking. Use when the user says "create ticket", "new ticket", or "track this".
Diagnose an integration/E2E test log, classify failures by severity, and batch-create issues. Use when the user says "smoke test", "diagnose log", "triage test log", or provides a test log.
Pull Linear issues and generate a local snapshot for quick reference. Use when the user says "sync linear", "pull linear issues", "update from linear", or "show my issues".
Triage, prioritize, and groom Linear issues. Use when the user says "triage linear", "review inbox", "prioritize issues", "groom backlog", or "clean up issues".
Investigate a bug using structured differential diagnosis. Use when the user says "diagnose", "investigate this", "what's causing this", or "figure out why".