Handoff Generator — Pass the Torch

Produce a single self-contained markdown document that lets you (or any other AI coding agent) resume the current task in a brand-new conversation with zero prior context. The reader has none of this chat's memory — so the document, not the conversation, has to carry everything: what the task is, where the code lives, how to run and test it, what's left, and the traps already discovered.

Treat this as writing a letter to a competent stranger who will pick up exactly where you left off. If a fact only lives in this chat's scrollback, it must make it into the file.

Output location and filename

Save to docs/handoff/ (create the directory if missing). Filename format:

YYYYMMDD-HHMM-{slug}.handoff.md

• Timestamp: get the real local time with date +"%Y%m%d-%H%M". Never invent it.
• {slug}: 3-4 meaningful words, kebab-case, preferably English (keeps filenames sortable and portable). Make it specific to the task — team-subscriptions-handoff, checkout-bug-fix, search-index-migration — not generic like task or wip.
• The .handoff.md double extension is intentional: it marks the file as a handoff while staying valid markdown.

Language