Wrap Up

Wrap-Up: End-of-Session Cleanup Protocol

When the user signals the end of a session, perform ALL of the following steps silently. Do not ask questions, do not explain what you are doing, do not narrate the process. Just do it.

When all steps are complete, respond with exactly:

"Wrap-up complete. See you in the next life."

Nothing else. No summary, no bullet points, no follow-up questions.

Step 1: Session Log

Create or append to a session log file at: [project_root]/Code/_Claude Session Logs/YYYY-MM-DD.md

If multiple sessions occur on the same day, append to the existing file with a horizontal rule separator and a timestamp.

Create the Code/_Claude Session Logs/ directory if it does not exist.

Session log format

# Session Log — YYYY-MM-DD

**Session time:** [approximate start–end based on conversation context]

## What was done
- [Concrete accomplishments — be specific and verifiable]
- [e.g., "Wrote data cleaning script code/01_clean.R"]
- [e.g., "Ran baseline DiD specification, results in output/tables/"]

## Key decisions made
- [Design choices, methodology decisions, direction changes]
- [e.g., "Decided to cluster SEs at state level rather than firm level"]

## Problems encountered
- [Bugs, data issues, dead ends — anything worth knowing next time]

## Files created or modified
- `path/to/file1.R` — [brief description of change]
- `path/to/file2.tex` — [brief description of change]
- `path/to/new_file.R` — [created: purpose]

## Where we left off
- [Exact state of work — what was mid-progress, what's next]

To compile the files list, check the conversation history for any files that were created, edited, or generated during this session. Include the path relative to the project root and a brief note about what changed or why the file was created.

Step 2: CLAUDE.md Update

Read the current CLAUDE.md in the project root. Determine whether anything learned during this session should be added:

• New project conventions established
• Package or tool preferences clarified
• Data structure or pipeline details discovered
• File paths or naming conventions adopted
• Build/run commands identified
• Variable definitions or data quirks uncovered

If there are meaningful updates, append them to the appropriate section of CLAUDE.md. Do not rewrite existing content — only add genuinely new information. If nothing new was learned, skip this step silently.

Do NOT add:

• Temporary or session-specific notes
• Task lists or to-do items (those go to the pinboard)
• Information that is already in CLAUDE.md
• Trivial details that would not help a future session

Step 3: README.md Update

Read the current README.md (if it exists). Check whether the project's folder structure has changed during this session:

• New directories created
• New key files added (scripts, data files, output)
• Significant reorganisation

If the structure has changed, update the folder tree in README.md to reflect the current state. If README.md has no folder tree section, add one. If nothing changed, skip this step silently.

Step 4: Memory Update

Write any new knowledge worth preserving to the auto memory system. Focus on information that would save time in a future session:

• Data quirks discovered (e.g., "CUSIP has trailing spaces in raw data")
• Gotchas encountered (e.g., "arrow fails on this file, use fread instead")
• Relationships between files or variables uncovered
• Correct commands or procedures figured out through trial and error
• Working solutions to problems that took effort to solve

If nothing novel was learned, skip this step silently.

Step 5: Pinboard Update

Read the current PINBOARD.md (if it exists — create it using the pinboard skill format if it does not exist and there are items to add).

Review the session for any open tasks, unfinished work, or follow-ups that were mentioned but not completed:

• Tasks the user said they would do later
• Ideas that came up but were not explored
• Bugs identified but not fixed
• Papers or references mentioned but not looked up
• Questions raised but not answered
• Analysis the user said they wanted to try but did not get to

Add each item to the appropriate category in PINBOARD.md:

- [ ] [YYYY-MM-DD] Note text here

Auto-categorise into To-Do, Papers, Ideas, or Data Issues based on content. If nothing is outstanding, skip this step silently.

Step 6: Git Commit (session-scoped)

Check the Git status of the project. If it is not a Git repository, or there are no uncommitted changes, skip this step silently.

Otherwise, stage only files actually touched during this session — never use git add . or git add -A. Orphan uncommitted changes from prior sessions or external tools must be surfaced to the user, not silently swept into the wrap-up commit.

6.1 Detect uncommitted changes

Run git status --porcelain to list all modified, staged, and untracked files.

6.2 Build session-touched list

Review the current session's tool-call history and collect every file path actually written to disk via Edit, Write, NotebookEdit, or Bash commands that create/modify files.

6.3 Classify

For each uncommitted file:

• Session change — appears in the session-touched list.
• Orphan — does not appear in the session-touched list.

6.4 Handle orphans explicitly

If any orphans exist, ask the user once:

The following files have uncommitted changes but were not modified during this session: [list]. Include them in the wrap-up commit, or leave them for later?

Default to excluding orphans if the answer is ambiguous or absent.

6.5 Stage only confirmed files

Stage session-touched files (and any orphans the user explicitly confirmed) by name:

git add -- "path/one" "path/two"

Do not use git add . or git add -A. If nothing remains to stage after orphan exclusion, skip the commit silently.

6.6 Commit

Commit with the message: wrap-up: end of session YYYY-MM-DD. Do NOT push — just commit locally.

If the commit fails for any reason (merge conflict, hooks, etc.), note the failure in the session log under "Problems encountered" but do not ask the user about it — just proceed with the wrap-up.

Important Rules

• Be silent. Do not narrate what you are doing. No "I'll now update the session log..." — just do it.
• Be conservative. Only write information that is genuinely useful. An empty update is better than a noisy one.
• Do not duplicate. If something is already captured in CLAUDE.md, PINBOARD.md, or memory, do not add it again.
• Do not modify author code or data. This skill only touches documentation and project management files (plus the git commit).
• Create directories as needed. If Code/_Claude Session Logs/ does not exist, create it. Do not ask.
• Respect existing content. Append to files, do not overwrite them. Read before writing.
• The closing line is sacred. After all steps are complete, respond with exactly: "Wrap-up complete. See you in the next life." Nothing before it. Nothing after it.