SKILL.md
$27
---
type: learning
source: retro-quick
source_bead: <active bead id when available>
source_phase: validate
date: YYYY-MM-DD
maturity: provisional
utility: 0.5
---
# 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`If no bead is active, omit source_bead intentionally and still set source_phase: validate.
- 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.
Examples
User says: /retro --quick "macOS cp alias prompts on overwrite — use /bin/cp to bypass"
What happens:
- Agent generates slug:
macos-cp-alias-overwrite
- Agent resolves the active bead with
timeout_run 1 bd current 2>/dev/null || echo ""
- Agent writes learning to
.agents/learnings/2026-03-03-quick-macos-cp-alias-overwrite.mdwith provenance fields like:
---
type: learning
source: retro-quick
source_bead: bd-123
source_phase: validate
date: 2026-03-03
maturity: provisional
utility: 0.5
---- Agent confirms:
Learned: macOS cp alias prompts — use /bin/cp
Troubleshooting
Problem
Cause
Solution
Learning too generic
Surface-level capture
Be specific: "auth tokens expire after 1h" not "learned about auth"
Duplicate learnings
Same insight captured twice
Check existing learnings with grep before writing
Need full retrospective
Quick capture isn't enough
Use /post-mortem for comprehensive extraction + processing