implementation.md

checkpoint.md

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

Steps Determine today's date in UTC (use the currentDate context if available).

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

Derive a short kebab-case topic slug from the main subject of this session (e.g. data-model-optimization, forecast-failure-model).

Propose the filename: docs/agents/checkpoint/YYYY-MM-DD-NNN-.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: — is that correct? If not, provide the filename to use instead." Wait for confirmation or a corrected name before writing.

Write the checkpoint document to the confirmed path. It should include:

1. What was accomplished — concrete deliverables, commands added, files changed
2. Key decisions — architectural choices, trade-offs, things that were explicitly ruled out and why
3. 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
4. A high level Summary of the document for the agent to quickly scan for its relevance in future.
5. Match the style and depth of the existing checkpoint docs in docs/agents/checkpoint/.

INSTALL_CLAUDE_skill.md

1. Install the checkpoint.md into .claude/commands/checkpoint.md
2. In your project's CLAUDE.md file, add

Read `docs/agents/checkpoint/*.md` for context. Every document here must have Summary section that provides high level summary."

3. Whenever you've finished doing a coherent "thing", or otherwise want to document all the stuff that's in your current session, type /checkpoint. It'll generate a file named e.g. docs/agents/checkpoint/2026-03-30-<topic>-001.md. It'll ask you if you like the name, and you can say "yes" or Optionally, type "/rename 2026-03-23-<topic-actually-what-i-did>-001.md into claude, followed by "/exit" and then "claude" to re-open a fresh session. You can resume the previous session with claude 2026-03-23-<topic>-001.