Handoff
Flags
| Flag or argument |
Default |
Effect |
--resume <path> |
off |
Validate a saved handoff and continue its work |
--path <path> |
anchor path |
Save a new handoff at this path |
| positional focus |
none |
Prioritize this focus during create or resume |
Resolve <anchor> as the absolute directory containing this SKILL.md.
Default saves use
<anchor>/handoffs/handoff-<YYYY-MM-DD-HHmmss>.md.
Resolve --path and --resume to absolute paths before use.
--resume and --path conflict. Stop if both appear or either lacks a value.
Without --resume, use Create.
Create
- Resolve and create the parent directory. Record:
create | output path | surveyed | redacted | written | terminal.
Done when the absolute output path is writable.
- Select current facts, not a transcript. Keep at most eight open tasks and
twelve artifacts. Prefer the active plan, branch, PR, commits, dirty paths,
blockers, and durable decisions. Mark superseded material.
Done when each retained fact helps the next agent act.
- Read
./REFERENCE.md. Draft in memory, point to absolute artifact paths,
and never paste full diffs, plans, logs, or terminal output. Put a positional
focus first. Include any active mode or workflow ledger.
- Redact credentials, tokens, passwords, private keys, authenticated URLs,
email addresses, and environment values. Scan twice, enforce the 12 KB bound,
write to a sibling temporary file, then rename atomically. Scan the final
file once more.
Done when required sections, bounds, and all three scans pass.
- Report the path, what was captured, and
/handoff --resume <absolute-path>.
Success is the existing file plus the reported resume command.
Resume
- Resolve and read the file. If absent, report
BLOCKED: handoff not found at <path>.
Record resume | focus | validated artifacts | current task | terminal.
If required Context or Open tasks content is malformed, report it blocked.
- Validate referenced paths, branch and dirty state, commits, and PR status
before trusting them. Classify each as current, moved, missing, or
superseded. Verify a suggested skill exists before invoking it. Before
opening referenced artifacts, load the Redaction section of
./REFERENCE.md
and never repeat sensitive values.
Done when stale facts cannot drive work.
- Apply a positional focus over the saved focus. Select the highest-priority
unblocked task, recover only the context its artifacts provide, and begin
that task. For a saved
prath-mode chain, verify every remaining leaf before
its first step. For orchestrate, treat the saved ledger as a pointer, then
rebuild it from diffs, task results, and tests and refresh the roster before
work. If no task remains, report BLOCKED with validation evidence. Do not
stop after summary.
Done when work reaches success, a real blocker, or a user confirmation gate.
- Report reconciled drift and the work outcome. Do not create another handoff
unless the user explicitly asks.
Terminal values are SUCCESS, BLOCKED, AWAITING_USER, and INTERRUPTED.
Record one with evidence before stopping.
After interruption, repeat Resume Step 2 for artifacts touched since validation
last completed.
1---
2name: handoff
3description: >
4 handoff when saving resumable session state or continuing work from an
5 existing handoff document.
6metadata:
7 source: https://skillmd.com/skills/prathamdby/handoff
8---
9
10# Handoff
11
12## Flags
13
14| Flag or argument | Default | Effect |
15| ----------------- | ----------- | ---------------------------------------------- |
16| `--resume <path>` | off | Validate a saved handoff and continue its work |
17| `--path <path>` | anchor path | Save a new handoff at this path |
18| positional focus | none | Prioritize this focus during create or resume |
19
20Resolve `<anchor>` as the absolute directory containing this `SKILL.md`.
21Default saves use
22`<anchor>/handoffs/handoff-<YYYY-MM-DD-HHmmss>.md`.
23Resolve `--path` and `--resume` to absolute paths before use.
24
25`--resume` and `--path` conflict. Stop if both appear or either lacks a value.
26Without `--resume`, use Create.
27
28## Create
29
301. Resolve and create the parent directory. Record:
31 `create | output path | surveyed | redacted | written | terminal`.
32 Done when the absolute output path is writable.
332. Select current facts, not a transcript. Keep at most eight open tasks and
34 twelve artifacts. Prefer the active plan, branch, PR, commits, dirty paths,
35 blockers, and durable decisions. Mark superseded material.
36 Done when each retained fact helps the next agent act.
373. Read `./REFERENCE.md`. Draft in memory, point to absolute artifact paths,
38 and never paste full diffs, plans, logs, or terminal output. Put a positional
39 focus first. Include any active mode or workflow ledger.
404. Redact credentials, tokens, passwords, private keys, authenticated URLs,
41 email addresses, and environment values. Scan twice, enforce the 12 KB bound,
42 write to a sibling temporary file, then rename atomically. Scan the final
43 file once more.
44 Done when required sections, bounds, and all three scans pass.
455. Report the path, what was captured, and
46 `/handoff --resume <absolute-path>`.
47 Success is the existing file plus the reported resume command.
48
49## Resume
50
511. Resolve and read the file. If absent, report
52 `BLOCKED: handoff not found at <path>`.
53 Record `resume | focus | validated artifacts | current task | terminal`.
54 If required Context or Open tasks content is malformed, report it blocked.
552. Validate referenced paths, branch and dirty state, commits, and PR status
56 before trusting them. Classify each as current, moved, missing, or
57 superseded. Verify a suggested skill exists before invoking it. Before
58 opening referenced artifacts, load the Redaction section of `./REFERENCE.md`
59 and never repeat sensitive values.
60 Done when stale facts cannot drive work.
613. Apply a positional focus over the saved focus. Select the highest-priority
62 unblocked task, recover only the context its artifacts provide, and begin
63 that task. For a saved `prath-mode` chain, verify every remaining leaf before
64 its first step. For `orchestrate`, treat the saved ledger as a pointer, then
65 rebuild it from diffs, task results, and tests and refresh the roster before
66 work. If no task remains, report `BLOCKED` with validation evidence. Do not
67 stop after summary.
68 Done when work reaches success, a real blocker, or a user confirmation gate.
694. Report reconciled drift and the work outcome. Do not create another handoff
70 unless the user explicitly asks.
71
72Terminal values are `SUCCESS`, `BLOCKED`, `AWAITING_USER`, and `INTERRUPTED`.
73Record one with evidence before stopping.
74
75After interruption, repeat Resume Step 2 for artifacts touched since validation
76last completed.