Retro Skill

YOU MUST EXECUTE THIS WORKFLOW. Do not just describe it.

Quick-capture a learning to the knowledge flywheel. For comprehensive retrospectives with backlog processing, activation, and retirement, use /post-mortem.

Flags

Quick Mode

Given /retro --quick "insight text" or /retro "insight text":

Quick Step 1: Generate Slug

Create a slug from the content: first meaningful words, lowercase, hyphens, max 50 chars.

Quick Step 2: Write Learning Directly

Write to: .agents/learnings/YYYY-MM-DD-quick-<slug>.md

---
type: learning
source: retro-quick
date: YYYY-MM-DD
---

# Learning: <Short Title>

**Category**: <auto-classify: debugging|architecture|process|testing|security>
**Confidence**: medium

## What We Learned

<user's insight text>

## Source

Quick capture via `/retro --quick`

This skips the pool pipeline — writes directly to learnings, not .agents/knowledge/pending/.

Quick Step 3: Confirm

Learned: <one-line summary>
Saved to: .agents/learnings/YYYY-MM-DD-quick-<slug>.md

For comprehensive knowledge extraction, use `/post-mortem`.

Done. Return immediately after confirmation.

Full Retrospective

For comprehensive knowledge extraction with backlog processing and activation, use:

/post-mortem <target>

The /post-mortem skill includes all retro functionality plus:

• Council validation of completed work
• Backlog deduplication and scoring
• Auto-promotion to MEMORY.md
• Stale learning retirement
• Harvest next work items

Examples

Quick Capture

User says: /retro --quick "macOS cp alias prompts on overwrite — use /bin/cp to bypass"

What happens:

1. Agent generates slug: macos-cp-alias-overwrite
2. Agent writes learning to .agents/learnings/2026-03-03-quick-macos-cp-alias-overwrite.md
3. Agent confirms: Learned: macOS cp alias prompts — use /bin/cp

Result: Learning captured in 5 seconds, indexed for future sessions.

Troubleshooting