wrap · diff
git:20261028.4be677d to git:20261028.b4a016c
4 added, 0 removed. Audit A to A.
---
name: wrap
description: Write the handoff brief so the session can be cleared and resumed in a fresh context.
---
# Wrap
Use at a task boundary, or when context is near its ceiling.
1. Run the brief writer — it derives the facts from the transcript, not from memory:
```
+ # Windows
powershell -NoProfile -ExecutionPolicy Bypass -File "$env:USERPROFILE\.claude\skills\opus-tuner\scripts\brief.ps1"
+
+ # macOS / Linux
+ pwsh -NoProfile -File "$HOME/.claude/skills/opus-tuner/scripts/brief.ps1"
```
If `CLAUDE_CONFIG_DIR` is set, substitute it for `~/.claude` in that path.
2. Read `.claude/handoff.md` and replace the four placeholder sections:
- **Decisions** — what was chosen and why
- **Dead ends** — what was tried and failed, so it is not retried
- **Unverified assumptions** — believed but not proven
- **Next step** — one concrete action
Keep the whole file under ~600 words. It is re-injected verbatim into the new
session, so every line costs tokens there.
3. Tell the user, in one line:
> Brief written. Run `/clear` — I will pick up from it automatically.
Do **not** run `/compact` instead. A handoff replaces the conversation at a task
boundary with no summarization pass; `/compact` costs a full read of the context.