| name | session-wrap-up |
| description | Review a completed, paused, or blocked coding-agent session to identify friction, mistakes, near misses, missing context, and opportunities to improve future work. Use when the user asks to wrap up, run a retrospective, explain what issues the agent faced, capture lessons learned, or recommend improvements to repository instructions, documentation, skills, tooling, tests, or workflows. Produce an evidence-based, propose-only report; do not apply follow-up changes unless the user asks. |
Session Wrap-Up
Run a candid, compact retrospective of the current session. Base it on the
conversation, commands, tool output, edits, verification, and unresolved work;
do not invent friction to make the report look substantial.
Interrogate The Session
Ask yourself:
- Where did I lose time, take a false start, or repeat work?
- What did I misunderstand or assume too early?
- What did the user's questions or corrections reveal about unclear scope,
location, status, or explanation?
- Which instructions were missing, hard to discover, ambiguous, or in tension?
- Which code, documentation, architecture, or terminology did I have to
rediscover?
- Which tool, dependency, environment, build, or test failure slowed the work?
- What nearly went wrong, even if the final result was correct?
- What remains incomplete, uncertain, or insufficiently verified?
- What worked especially well and is worth preserving or standardising?
- What single change would most improve a similar session next time?
Verify the factual premise behind user questions and corrections against the
available evidence. Treat a correction as strong evidence of an expectation or
communication gap even when its diagnosis is not confirmed.
Before reporting the outcome, perform only the cheap read-only checks needed to
confirm the current state. For repository work, normally inspect working-tree
status and the changed-file summary, then reconcile them with verification
already recorded in the session. Do not rerun expensive tests solely for the
wrap-up. State when relevant evidence is unavailable.
