What problem does it solve? After an agent session, friction caused by missing instructions, stale documentation, or architectural issues is often forgotten instead of being captured as concrete repository improvements. This Skill closes that loop by turning session struggles into approved fixes, PRs, GitHub issues, or local notes. ## Core Features & Use Cases - Structured Finding Classification: Organizes session friction into four categories: instructions/configuration gaps, documentation gaps, architectural friction, and mistakes with corrections. - Disposition Routing: Assigns each finding to fix-now, open-pr, github-issue, or local-only buckets with guardrails that prevent auto-applying risky changes like schema migrations or CI/CD edits. - Approval-Gated Execution: Stays read-only until the user approves the report and each disposition bucket, then saves the retrospective to the spec-kit feature directory or a timestamped ad-hoc path. - Use Case: After a long coding session where the agent repeatedly misread AGENTS.md guidance and rediscovered a workflow, run the retrospective to produce a findings table, get a small doc fix applied immediately, and file a GitHub issue for the larger architectural concern. ## Quick Start Ask the agent to run a retrospective on the current session and route the findings to the appropriate follow-up actions.
