Trim CLAUDE.md, move status log to docs/status.md - #12
Merged
Merged
Conversation
CLAUDE.md is auto-loaded into every Claude Code session in this repo, so everything in it costs context on every turn. It had grown to 28k chars (~7k tokens), and two thirds of that was a dated status log rather than the durable guidance the file is for. Moved out, verbatim: - "Current state (2026-06-05)" -> docs/status.md. Per-tool changelog with live-verification findings. Genuinely useful history, just not something that needs to be resident every session. - "Next session: start here" -> superseded. WISHLIST.md already carried a fuller writeup for all four candidates (list_documents, reply_to_message, send_message polish, list_immunizations). - "New surfaces mapped 2026-05-06" -> superseded by the endpoint docs (billing.md, documents.md, upcoming_orders.md) and the BFF header warning already in medications.md. The five live-verification loose ends existed nowhere else, so they moved to a new "Live-verification backlog" section in WISHLIST.md rather than being dropped. Kept in CLAUDE.md: the endpoint gotchas, code conventions, region scope, dev and live-testing workflow, the do-not-copy-upstream rule, and style. Those are the things a session cannot re-derive from the code. CLAUDE.md: 28,045 -> 10,017 chars (~7,010 -> ~2,500 est. tokens/session). No content was deleted; every line survives in CLAUDE.md, docs/status.md, WISHLIST.md, or the endpoint docs it now points to. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Originally written 2026-07-28, rebased onto current
mainon 2026-07-29 after six intervening commits.What it does
CLAUDE.mdis auto-loaded into every Claude Code session in this repo, so its length is a per-session tax. This moves the status log, next-session candidates, and the 2026-05-06 surface mapping intodocs/status.md, and the live-verification backlog intoWISHLIST.md.31,279 → 13,183 characters, a 58% cut, with nothing deleted — only relocated.
What stays in
CLAUDE.mdis what you need while writing code: architecture, conventions, key endpoint facts, and the live-testing workflow.Rebase notes
The original commit predated a day of work that touched the same two files, so the conflict needed resolving rather than picking a side. Specifically preserved:
(inferred)response shapes are guesses, not factsPYTEST_CURRENT_TESTWISHLIST.mdA naive resolution would have taken the older file wholesale and silently reverted all six, including the PHI fix.
Brought current while rebasing
The moved content was a 2026-07-28 snapshot, so it described a world where
send_message's commit path had never been verified. Corrected in place:docs/status.md— thesend_messageentry now records the 2026-07-29 live verification and points at the postmortem. Its chain description omitted GetViewers entirely; removed rather than left to mislead. Test count 591 → 599. Header now carries a "last updated" line distinguishing the verbatim split from later edits.WISHLIST.md— the "live-verify thesend_messagecommit path" backlog item is struck through and done, with a note that the same inferred-shape risk applies to every remaining item on that list,request_refillfirst.CLAUDE.md— the summary now states plainly that the two write tools differ in maturity and shouldn't be treated alike.Verified
scripts/phi-scan.pypasses on the rebased treeCLAUDE.mdadditions confirmed present after the merge resolution🤖 Generated with Claude Code