Common Session Retrospective Agent Skill

Session Retrospective

Priority: P1 (HIGH)

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 | Trigger Miss
• Trigger Miss Check — For every task in session, ask: _" relevant skill available but not loaded?"_
• If yes: record skill ID, indirect phrase used, and fix (add keyword alias to triggers)
• Propose — One fix per root cause: revise existing guidance, update reference, add new skill, or add new workflow
• Implement — Only when current task explicitly authorizes repository maintenance, apply the approved repo changes across configured agent dirs. Keep SKILL.md concise; move large tables to references/. Update AGENTS.md
• Log to AGENTS_LEARNING.md — For each correction loop found, append one entry using common/common-learning-log protocol (Signal: Session retrospective)
• Report — Output correction count, skills changed, trigger misses found, estimated rounds saved

Trigger Miss Output

Emit trigger miss block (schema in references/methodology.md) for each miss detected.

Guidelines

• Cite specifics: Reference concrete conversation moment per proposal
• Extend first: Search AGENTS.md before creating — extend existing guidance first
• One fix per loop: One correction → one targeted skill change
• Stay task-scoped: Only change repository library source during explicit maintenance work for the repository
• Sync all agents: Apply to every agent skill dir listed in .skillsrc agents field
• Follow skill-creator: New skills comply with common/skill-creator standards

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

Canonical response anchors

When this skill applies, preserve the following domain terminology or equivalent concrete examples in the answer when relevant:

• AGENTS.md and AGENTS_LEARNING.md