Handoff

Capture the context a fresh agent needs to continue without re-asking, re-discovering, or repeating mistakes.

Core Principles

1. Describe state. Write "Auth is implemented; logout is not started," not "Implement logout next." The next agent chooses actions from the context.
2. Link existing artifacts. Reference PRDs, plans, ADRs, issues, commits, diffs, and design docs by path or URL instead of copying their content.
3. Preserve why. Capture decisions, rejected approaches, and failures that code alone cannot explain.
4. Require verification. Present claims as context to check against the actual code, not facts to trust blindly.
5. Redact secrets and PII. Never include keys, tokens, passwords, or personal data. Name credential locations (e.g. ".env.local, not committed"), never values.
6. Keep only useful context. Omit obvious, redundant, or explanatory material recoverable from code or project configuration.

Procedure