Loading...
Loading...
Use when a session is running out of context and the work needs to continue in a fresh one, or when starting a session meant to pick up where an earlier one stopped. Not for compacting in place — that is /compact — and not for specifying work that has not started, which is a plan.
npx skill4agent add ovid/paad handoffpaad/config/paad.mdpaad/config/handoff.mdConfig: <path>handoff.md/compact--continue--resume/clearhandoff/compactdigraph handoff_save {
"Argument given?" [shape=diamond];
"Use the named mode" [shape=box];
"Conversation above this invocation?" [shape=diamond];
"Say: saving, session has history" [shape=box];
"Resume flow, below" [shape=box];
"handoff.md in .gitignore?" [shape=diamond];
"Suggest adding it, never add it silently" [shape=box];
"Verify every checkable claim with tools" [shape=box];
"Claim survived verification?" [shape=diamond];
"Write it as fact" [shape=box];
"Correct it, or mark it inferred" [shape=box];
"handoff.md absent, or not a symlink?" [shape=diamond];
"Write nothing; tell the user, ask where to save it" [shape=box];
"Write handoff.md with the Write tool" [shape=box];
"Name the unverified claims, ask for review" [shape=box];
"Announce the artifact" [shape=box];
"Argument given?" -> "Use the named mode" [label="save or resume"];
"Argument given?" -> "Conversation above this invocation?" [label="no"];
"Conversation above this invocation?" -> "Say: saving, session has history" [label="yes"];
"Conversation above this invocation?" -> "Resume flow, below" [label="no"];
"Use the named mode" -> "Say: saving, session has history" [label="save"];
"Use the named mode" -> "Resume flow, below" [label="resume"];
"Say: saving, session has history" -> "handoff.md in .gitignore?";
"handoff.md in .gitignore?" -> "Suggest adding it, never add it silently" [label="no"];
"handoff.md in .gitignore?" -> "Verify every checkable claim with tools" [label="yes"];
"Suggest adding it, never add it silently" -> "Verify every checkable claim with tools";
"Verify every checkable claim with tools" -> "Claim survived verification?";
"Claim survived verification?" -> "Write it as fact" [label="yes"];
"Claim survived verification?" -> "Correct it, or mark it inferred" [label="no"];
"Write it as fact" -> "handoff.md absent, or not a symlink?";
"Correct it, or mark it inferred" -> "handoff.md absent, or not a symlink?";
"Write handoff.md with the Write tool" -> "Name the unverified claims, ask for review";
"Name the unverified claims, ask for review" -> "Announce the artifact";
"handoff.md absent, or not a symlink?" -> "Write handoff.md with the Write tool" [label="yes"];
"handoff.md absent, or not a symlink?" -> "Write nothing; tell the user, ask where to save it" [label="no"];
"Write nothing; tell the user, ask where to save it" -> "Write handoff.md with the Write tool" [label="user names a safe path"];
}digraph handoff_resume {
"handoff.md exists?" [shape=diamond];
"Say so, offer to save one instead" [shape=box];
"Read it, summarize in a few lines" [shape=box];
"Recorded commit matches HEAD?" [shape=diamond];
"Report the drift before asking" [shape=box];
"Ask: proceed?" [shape=diamond];
"Stop, leave the file alone" [shape=box];
"Check the files and state it names" [shape=box];
"Everything matches?" [shape=diamond];
"Report every mismatch, ask again" [shape=box];
"Start the recorded next step" [shape=box];
"Leave handoff.md in place" [shape=box];
"handoff.md exists?" -> "Read it, summarize in a few lines" [label="yes"];
"handoff.md exists?" -> "Say so, offer to save one instead" [label="no"];
"Read it, summarize in a few lines" -> "Recorded commit matches HEAD?";
"Recorded commit matches HEAD?" -> "Ask: proceed?" [label="yes"];
"Recorded commit matches HEAD?" -> "Report the drift before asking" [label="no"];
"Report the drift before asking" -> "Ask: proceed?";
"Ask: proceed?" -> "Check the files and state it names" [label="yes"];
"Ask: proceed?" -> "Stop, leave the file alone" [label="no"];
"Check the files and state it names" -> "Everything matches?";
"Everything matches?" -> "Start the recorded next step" [label="yes"];
"Everything matches?" -> "Report every mismatch, ask again" [label="no"];
"Report every mismatch, ask again" -> "Start the recorded next step" [label="user confirmed"];
"Start the recorded next step" -> "Leave handoff.md in place";
}/handoff/handoff save/handoff resumesaveresume.gitignorehandoff.md.gitignore| Claim | Settle it with |
|---|---|
| Current commit, branch, dirty state | |
| What is actually in the last commit | |
| A file path | Read it, or |
| A line number | Read the file and look |
| A test's name or file | Grep for it |
| Whether the suite passes, and what fails | Run it |
| A quoted sentence and who said it | Find it in the conversation, or do not quote it |
handoff.mdtest ! -L handoff.mdbash > handoff.md# Handoff — <one-line task name>
Written <date time> · branch `<branch>` · commit `<short sha>`
Uncommitted: <one line — what is dirty, what is staged>
## Goal
What we are trying to achieve, and what "done" looks like.
## Decisions
Chose X over Y, because Z. One line each.
## Ruled out
What was tried, how it failed, and how far it got. One line each.
## Constraints
Things the user said that exist nowhere on disk. Quote them.
## Next step
The single immediate action, with the file and line to start at.
## Verify
The command that says whether it worked.
## Unverified
Anything above that could not be checked, marked as inferred.
Delete this section if it is empty — do not pad it.git loggit diff/compactTwo things to check before you rely on this. I inferred the next step from what we were doing rather than from anything you said outright, and I could not confirm the second constraint is still live — it came from early in the session. Everything downstream is built on both.
Files written or updated:
new handoff.md4 source files changed in src/dbsync/ (see git diff)handoff.mdhandoff.mdhandoff.md| Mistake | What to do instead |
|---|---|
| Writing file paths, line numbers, or test names from memory | These are the errors. Check each one with a tool first — it costs seconds. |
| Quoting the user's constraint and attributing it to a name | The conversation may never state who said it. Quote the sentence; do not invent the speaker. |
| Trusting the last commit's message for what it contains | |
| Including an architecture tour or a file-by-file layout | Recoverable by opening the repo. It buys nothing and costs the review. |
| Narrating how the session unfolded | The next session needs the conclusions, not the journey. |
| Stating inferred and verified claims in the same register | Mark the inferred ones. Uniform confidence is what hides the errors. |
| Filing a claim under "Unverified" instead of checking it | That section is for what a tool genuinely cannot settle. If |
| Closing with "review this, AI makes mistakes" | Name the two or three claims that actually need checking. |
| Deleting the handoff after resuming | It is untracked; git cannot restore it. Let the next save overwrite it. |
| Resuming straight into the work without checking the tree | The handoff may be describing a state that no longer exists. |
Writing the file with | Use the Write tool. A shell redirect leaves no recovery copy. |
| Running this to compact the current session | That is |
rm handoff.md