Resume Claude Code work from saved decisions and session logs
At a glance
Paul Mederos keeps a private context repository so Claude Code can recover project decisions and open threads between sessions. This workflow is listed under Agent Memory, Session Handoffs, Project Context.
- Agents / tools
- Claude Code, Git, Markdown
SourceBuilding a tool for these workflows? See weekly rates.
What they did
1) Create a private Git context repository for Claude Code. Add `CLAUDE.md` as loader, `profile.md`, `voice.md`, `.partner_model.md`, `.self_model.md`, and a `sessions/YYYY_wNN/` log directory. Point `~/.claude/CLAUDE.md` to the repository's loader with an `@` include. 2) At session start, pull the context repository, read both model files and the latest session log, and fetch active project repositories before checking state. Read same-day logs and search earlier ones when continuing a topic. 3) Work normally. At a milestone or wrap-up, ask Claude to record context, completed work, decisions and rejected alternatives, files, open threads and commits in a dated session log. 4) Update both model files with lessons, then commit and push all three artifacts. 5) Start the next session by loading that record; periodically distill lessons and remove stale entries.
How it went
Mederos reports 135 logs over four months and resuming work with prior decisions and open threads recovered.
Worth knowing
His context repositories are private; other people's context is read-only. The workflow requires ongoing maintenance.