Keep a readable per-topic memory for Claude Code across twenty work streams

Data consultant Kenny Peeters gave Claude Code one Markdown file per topic plus commands for ideas, mail digests and sprint planning, so a session now starts with one sentence instead of five minutes of context.

Done withClaude CodeinOutlook MailOutlook Calendar· Oct 30, 2026 · 2 accounts

What they did

Peeters juggles more than twenty topics across a client, an employer and side projects, each spread over repos, Jira, mail and folders. Each Claude Code session started from zero. Over about four days, mostly by talking to Claude, Peeters built a system: one Markdown doc per topic with location, dated status, decisions with reasons and open items, plus an index. Rules in the global CLAUDE.md tell Claude to read the index and topic doc first and update the doc after progress unprompted, and a Stop hook reminds it once if it forgot. Slash commands triage new ideas against existing topics, search across docs, propose cleanups, and plan a sprint by estimating open items and reading the calendar read-only for holidays. A cheaper-model subagent reads mails Peeters drags into a per-topic Outlook folder and returns only a digest of decisions and deadlines. A single local HTML file serves as the dashboard.

How it went

Starting a session now takes one sentence, "continue with topic X", instead of about five minutes of explaining. The mail subagent cut the text the main session handled for the first real thread from about 78 KB to 14 KB. Ideas, cleanups and sprints all stop for approval, and nothing writes to the calendar; Peeters imports an .ics file himself. When Peeters packaged it as a repo, a fresh Claude agent installed it from INSTALL.md into a fake home folder, and it found fifteen unclear spots in the instructions.

Worth knowing

Token cost came from raw data in the main conversation, not the docs, so the rules say check sizes before loading and send bulk reading to a smaller model. It runs on a locked-down corporate laptop with no new connections to client systems: Outlook is read locally and Jira comes in as a CSV export. Keep client, employer and personal contexts strictly apart.

Try it

With Claude Code· 4 parts to fill in

Set up a memory for my work in [folder path]. Create an INDEX.md with one line per topic and one Markdown doc per topic from this list: [my topics]. Each doc holds only what the code cannot tell you: where it lives, dated status lines, decisions with the reason, and open items as checkboxes. Add rules to my global CLAUDE.md: read the index and the matching doc before acting, update the doc after meaningful progress without being asked, and never mix [my contexts, e.g. client and personal]. Add a command that reads new mail in [mail folder] read-only through a subagent on a smaller model and records only decisions, deadlines and tasks. Show me every file change before you write it and stop after I approve the setup.

Square brackets are the parts to fill in. The prompt is ours; the story is theirs.

Where they said it

Related