Session Review & Handoff
Analyze agent sessions and prepare context handoffs for session continuity.
Purpose
This skill serves two complementary workflows:
Review (/pokayokay:review) — Retrospective analysis:
- Understand what the agent actually did vs what was planned
- Identify good patterns to reinforce and bad patterns to prevent
- Find wasted effort and context efficiency issues
- Generate improvements for skills, prompts, and workflows
Handoff (/pokayokay:handoff) — Forward-looking context preservation:
- Document completed work and in-progress state
- Capture decisions, blockers, and next steps
- Track skill usage and ad-hoc work
- Prepare context for the next session or agent
When NOT to Use
- Auditing feature completeness — Use
feature-auditfor PRD gap analysis; this skill analyzes agent behavior - Planning new work — Use
planningfor PRD breakdown; this skill reviews completed sessions
Key Principles
- Compare plan vs reality — what was expected vs what happened
- Assess work quality — were reviews passing? How many cycles?
- Detect patterns — recurring issues across multiple sessions
- Learn from checkpoints — were pauses at the right moments?
Quick Start Checklist
- Gather session data (git log, ohno activity, session notes)
- Analyze execution against original task plan
- Evaluate quality metrics (review pass rate, cycle count)
- Identify patterns (positive and negative)
- Generate actionable improvements
References
| Reference | Description |
|---|---|
| pattern-library.md | Common session patterns and their fixes |
| analysis-scripts.md | Scripts for extracting session metrics |
| review-report-template.md | Template for session review reports |
| handoff-guide.md | Handoff state documentation, templates, ohno integration |