.claude/commands/handoff.md - see https://news.ycombinator.com/item?id=47581936

handoff.md

Write a handoff document summarising this session for future agents/sessions.

Steps

1. Determine today's date (use the currentDate context if available).

2. List the existing files under docs/agents/handoff/ to find the highest sequence number already used today, then increment by one. Format: NNN (zero-padded to 3 digits, starting at 001).

3. Use the current session name, otherwise derive a short kebab-case topic slug from the main subject of this session (e.g. eth-brownie-optimization, filter-sol-wsol-command).

4. Propose the filename: docs/agents/handoff/YYYY-MM-DD-NNN-<slug>.md where NNN is the largest existing NNN plus one for that specific day (e.g. 2026-03-23-001, 2026-03-23-002, 2026-03-24-001, etc) Ask the user: "Proposed filename: <path> — is that correct? If not, provide the filename to use instead." Wait for confirmation or a corrected name before writing.

5. Write the handoff document to the confirmed path. It should include:

   • What was accomplished — concrete deliverables, commands added, files changed
   • Key decisions — architectural choices, trade-offs, things that were explicitly ruled out and why
   • Important context for future sessions — data locations, known pre-existing failures, branch status, anything a fresh agent would need to pick up the work without re-discovering it

   Match the style and depth of the existing handoff docs in docs/agents/handoff/.