Done

End of Session Wrap-up

When the user invokes /done, perform these end-of-session tasks in order.

0. Detect Project Type

Check the project's .claude/CLAUDE.md for a project-type: field:

• data-science — Full wrap-up including all steps
• general (or no field found) — Skip steps marked [Data Science only]

If no field exists, infer: renv.lock, outs/, or numbered XX_*.qmd scripts → data science. Otherwise → general.

1. Summarize Work and Decisions

Briefly list what was completed this session:

• Scripts created or modified
• Data files created or modified
• Documentation changes
• Key analytical or design decisions made

2. Update Relevant Planning Documents

Only update planning documents directly relevant to this session's work. Do NOT read all registered documents — identify the 1-2 that matter from session context.

For each relevant planning document:

a. Status tables — Mark completed phases/tasks. Add new phases if needed. When a phase is marked complete, collapse its detailed content to a 3-5 line summary (what was done, key outcomes). Before collapsing, ensure any forward-looking information needed by future phases is already captured elsewhere in the plan.

b. Script and file tracking — Add new scripts, mark replaced ones as legacy, update modified entries.

c. Task lists — Check/uncheck items as appropriate.

Show proposed changes before editing.

Also check Claude Code plan files

If a plan file from plan mode exists in ~/.claude/plans/ and is relevant:

• Update status tables, file tracking, task checklists
• If it contains significant multi-session tracking, suggest promoting to a registered .claude/ document

3. Update Project Documentation (if needed)

Only do these checks if the session actually changed something relevant. Skip silently otherwise.

Canonical Data Files Registry [Data Science only]

If canonical data files were created, replaced, or had format changes:

• Update CURRENT/Legacy status entries
• Add new files that should be tracked
• Show proposed changes before editing

Project CLAUDE.md

If new conventions, gotchas, or important patterns were discovered this session, propose additions. Only record things that are surprising or counter-default — skip anything Claude would infer from the codebase.

MEMORY.md

If reusable lessons or gotchas were discovered, or existing entries proved wrong/outdated, propose updates. Keep under 200 lines.

New .claude/*.md files

If new .claude/*.md files were created this session, add them to the Project Document Registry.

CHANGELOG.md

If the project has a CHANGELOG.md in its root directory:

• Review what was done this session
• Propose a changelog entry under today's date, using the existing format (Added/Changed/Fixed/Removed sections as appropriate)
• If today's date already has an entry, append to it rather than creating a duplicate
• Show proposed changes before editing
• If no CHANGELOG.md exists, skip silently — do not suggest creating one

4. Git Commit

Project repository

Run git status to check for uncommitted changes.

If there are changes:

• CRITICAL: Only include files actually created or modified during THIS session
• Identifying session files — use multiple sources, not just git diff:
  1. Conversation context is the primary record of what you did — including compacted/summarized earlier portions of the conversation
  2. Git diff (initial gitStatus vs current git status) is a cross-check — files appearing in current but not initial are candidates but not certainties
  3. Parallel conversations can create files — another Claude Code session running simultaneously may have added files that show up in your git diff but were NOT created by this conversation
  4. When uncertain about a file's origin, ask the user — do not silently include or exclude files you can't account for from conversation context
• Files already in initial gitStatus should NOT be included unless you worked on them
• Show the user session-relevant files and suggest a commit message
• If approved, commit only those files

User config (~/.claude)

Check for uncommitted changes:

git -C ~/.claude status --short

If there are changes (skills, CLAUDE.md, etc.):

• Show what changed
• Ask if user wants to commit and push
• If yes: git -C ~/.claude add -A && git -C ~/.claude commit -m "message" && git -C ~/.claude push

Skill registration check: If new skills were created in ~/.claude/skills/ this session, verify each appears in the Available Skills table in ~/.claude/CLAUDE.md. If any are missing, add them before committing.

Conditional: renv snapshot [Data Science only]

Only if R packages were installed or updated during this session:

Rscript -e "renv::status()" 2>/dev/null

If out of sync, ask about renv::snapshot(). Include updated renv.lock in the commit.

Conditional: Quarto publish

Check if this is a publishable Quarto project (all three must be true):

1. _quarto.yml exists
2. It's a book or website (type: book or type: website)
3. gh-pages branch exists

If yes, ask: "This is a Quarto book/website with GitHub Pages. Publish now?"

Do NOT offer for regular .qmd analysis scripts, projects without gh-pages, or type: default.

5. Final Summary

Brief "Session complete" message listing:

• Files created/modified
• Commits made
• Planning documents updated
• Any follow-up items for next session