Context Handoff
Goal: let a fresh agent continue without rereading the whole conversation.
Process
- Save to the OS temp directory by default, not the current workspace. Use the platform temp resolver when available, or
$TMPDIR//tmpon Unix-like systems, and report the final absolute path. - If the user requests a project artifact, save under the documented project handoff path.
- Reference existing PRDs, plans, diffs, commits, and docs by path or URL instead of duplicating them.
- Redact secrets, tokens, passwords, private keys, and personal data.
- Include suggested skills and agents for the next session.
Handoff Format
# Handoff: <topic>
## Current Goal
<one paragraph>
## Decisions
- <decision>
## Files And Evidence
- <path or URL>: <why it matters>
## Suggested Skills
- <skill>: <when to invoke>
## Suggested Agents
- <agent>: <workstream>
## Next Actions
1. <action>
## Open Questions
- <question, if any>
Rules
- Keep it compact.
- Do not duplicate content already stored in authoritative artifacts.
- Prefer paths and URLs over pasted content.
- Include enough verification state for a fresh agent to trust what is done.