| name | retrospect |
| description | Reflect on current session and record experience. /retrospect = remember. --plan = + backlog item. --fix = + implement now. |
Retrospect
Reflect on what just happened. Three escalation levels:
Command
/retrospect [--plan | --fix] [subject]
| Mode | What happens |
|---|
/retrospect | Record experience to .agents/memory/experience/ |
/retrospect --plan | Record experience + create backlog item in .agents/backlog/ |
/retrospect --fix | Record experience + create backlog item + implement the fix now |
Subject is optional. Without it — reflect on the current session trajectory. With it — reflect on the given topic or memory link.
Workflow
Default (/retrospect)
- Review current session — what went wrong, what was learned.
- Write to
.agents/memory/experience/YYYY-MM-DD-<slug>.md.
- Done.
Plan (/retrospect --plan)
- Everything from default.
- Create actionable item in
.agents/backlog/YYYY-MM-DD-<slug>.md with source: linking to the experience entry.
Fix (/retrospect --fix)
- Everything from
--plan.
- Implement the fix in code immediately.
- Update the backlog item status or delete it.
Rules
- Current trajectory first — without subject, reflect on what just happened, not on old files.
- Always record — every mode writes experience.
--plan adds backlog. --fix adds backlog + code.
- Link sources — backlog items reference the experience entry they came from.
- Merge, don't duplicate — if an observation or experience on the same topic exists, update it.
- Redact before write — memory landscape rules: omit landscape ids from experience/backlog; never paste fixtures in place of redacted real ids.
