handoff

name	handoff
description	Generate session handoff documents for work continuation. Use when transitioning between sessions.
context	fork
globs	[]
alwaysApply	false

Handoff — Session Continuation Summary

Use this skill to generate a structured handoff summary when transitioning work to a new session.

Policy-safe storage: keep handoffs in /memories/session/ during the conversation. Do not create ad-hoc .md files in the repository root.

---

When to Use

• Session is ending but work is incomplete
• Computer crash or logout mid-feature
• Switching to a different machine
• User wants to start fresh but continue the same work
• Context window is getting full and a fresh session would help

---

Handoff Format

# Handoff: <Feature Name>

## Current Status
- Wave N completed (<description>)
- Wave N+1 pending (<description>)
- Current task: <what was being worked on>

## What Was Completed
- <file/path> — <what was implemented>
- <file/path> — <what was implemented>
- <file/path> — <what was implemented>

## Remaining Work
- <remaining task 1>
- <remaining task 2>
- <remaining task 3>

## Key Decisions
- <decision 1> (rationale)
- <decision 2> (rationale)

## Learnings (from wisdom accumulation)
- <convention 1>
- <gotcha 1>
- <failure to avoid 1>

## Relevant Files
- <path/to/file1>
- <path/to/file2>
- <path/to/file3>

## Tasks Status (if using Task System)
- T-001 [completed] <subject>
- T-002 [completed] <subject>
- T-003 [in_progress] <subject>
- T-004 [pending] <subject>

## Next Steps
1. <immediate next action>
2. <following action>
3. <eventual action>

---

How to Persist Handoff (Policy-Compliant)

When user runs /handoff:

1. Mnemosyne reads current session state
2. Mnemosyne reads /memories/session/* (if relevant)
3. Mnemosyne generates handoff summary
4. Mnemosyne saves to /memories/session/handoff-<timestamp>.md
5. Mnemosyne outputs the summary in chat
6. At sprint close, promote only durable context to .pantheon/memory-bank via explicit @mnemosyne action

---

How New Session Uses Handoff

When starting a new session:

1. User pastes handoff document (or references file path)
2. New session reads handoff
3. Agent resumes from "Next Steps"
4. Tasks continue from last known state
5. Learnings are re-injected

---

Example

# Handoff: Product Reviews

## Current Status
- Wave 2 completed (backend endpoints + frontend with mocks)
- Wave 3 pending (real API integration)
- Current task: Connecting ReviewCard to real GET /reviews API

## What Was Completed
- src/routes/reviews/post.py — POST /reviews endpoint
- src/routes/reviews/get.py — GET /reviews with pagination
- src/components/ReviewCard.tsx — ReviewCard with mocked data
- alembic/versions/xxx_reviews.py — reviews table migration

## Remaining Work
- Connect ReviewCard to real GET /reviews API
- Add ReviewForm component
- Integration tests
- Error handling for 404/500

## Key Decisions
- Use Redis for review cache (TTL 5min) — decided after Wave 2 performance testing
- Cursor-based pagination, not offset — better for large datasets

## Learnings
- Convention: API returns snake_case, frontend converts to camelCase
- Gotcha: Reviews table needs composite index on (product_id, created_at)
- Failure: Don't use session.commit() in async — use await session.flush()

## Arquivos relevantes
- src/routes/reviews/
- src/components/ReviewCard.tsx
- src/components/ReviewForm.tsx (not created yet)
- alembic/versions/xxx_reviews.py

## Tasks Status
- T-001 [completed] Create reviews schema
- T-002 [completed] Implement POST /reviews
- T-003 [completed] Implement GET /reviews
- T-004 [completed] Build ReviewCard component
- T-005 [pending] Connect to real API
- T-006 [pending] Build ReviewForm
- T-007 [pending] Integration tests

## Next Steps
1. Update ReviewCard to call GET /reviews API (replace mock data)
2. Create ReviewForm component with POST /reviews integration
3. Write integration tests for full review flow

---

Relationship with Memory Bank

System	Scope	Duration
/memories/repo/	Permanent facts	Forever
.pantheon/memory-bank/	Project context	Sprint
/memories/session/handoff-*.md	Session handoff snapshot	Until session ends

Handoff is the most temporary — it's a snapshot of the current session for seamless continuation.