Session Retrospective
Priority: P1 (OPERATIONAL)
Structure
common/session-retrospective/
├── SKILL.md # Protocol (this file)
└── references/
└── methodology.md # Signal tables, taxonomy, report template
Protocol
- Extract — Scan for correction signals (loops, rejections, shape mismatches, lint rework)
- Classify — Root cause: Skill Missing | Incomplete | Example Contradicts Rule | Workflow Gap
- Propose — One fix per root cause: update skill, update reference, new skill, or new workflow
- Implement — Apply to all agent dirs. Keep SKILL.md ≤70 lines. Update
AGENTS.md - Report — Output correction count, skills changed, estimated rounds saved
Guidelines
- Cite specifics: Reference concrete conversation moment per proposal
- Extend first: Search
AGENTS.mdbefore creating — update existing skills - One fix per loop: One correction → one targeted skill change
- Sync all agents: Apply to every agent skill dir listed in
.skillsrcagentsfield - Follow skill-creator: New skills comply with
common/skill-creatorstandards
Anti-Patterns
- No Vague Proposals: Cite exact gap + fix, not "make X better"
- No Duplicate Skills: Search AGENTS.md index first
- No Oversized Patches: Extract to
references/per skill-creator standard
References
Signal tables, root cause taxonomy, report template, real-world example: references/methodology.md