Handoff

A fresh agent should orient from artifacts, not from a retelling. Bare invocation and create [focus] write one. resume [source] reads one. Natural-language create or resume follows the same split. "Continue" with no handoff intent is not this skill.

Create

Write docs/plans/handoffs/YYYY-MM-DD-<topic>.md. If the project AGENTS.md names another handoff directory, use that. Date is the request date. Slug is a few hyphenated words. Do not overwrite; on collision add -2, then -3.

Pointer-first. Link plans, issues, diffs, and files. For each link, one line on what matters there (add a line range when it helps). Do not paste those documents. Redact secrets and credentials. Say whether a decision was the user's or yours.

Sections, in order:

• State. What exists, what is partial, what is missing. Repo-relative paths. Absolute paths only for machine-local state, labeled machine-local.
• Decisions. Settled calls and rejected alternatives.
• Open questions. Unresolved, one line each. Do not invent any.
• Next step. One recommended step, not a menu.
• Links. Artifact paths this session produced or depended on.
• Board. When AGENTS.md or README.md names a GitHub Projects board, name the matching item (number and title). Read only. Do not move cards. Omit the section when no board or no match.
• ## todo.txt. End the file with a real ## todo.txt heading and one-line tasks. Required, even if the only line is "none".