docs: slim CLAUDE.md under the 40k char prompt budget#337
Merged
Conversation
New 43k reference doc owns the full per-protocol summary for all twelve shipped backends (reference impls, capabilities, operator overrides, doctor checks, Implementer Contracts, and the cliff each closes). Will be linked from CLAUDE.md in the follow-up commit so the session prompt can clear the 40k-char budget.
Replaces (a) the wall-of-text "What this is" paragraph and (b) the bullet-per-backend Status block with a one-line pointer to docs/protocols-shipped.md and a compact 12-row Status table. Adds a "Where things live" row for the new reference doc. Also corrects an inline-adjacent stale claim: spec count is 35 docs today, not 36 (spec/23 was never assigned). CLAUDE.md goes from 88,265 → 29,887 chars (66% smaller, well under the 40k char Claude Code prompt budget). Principles, methodology, conventions, and "When in doubt" sections are preserved verbatim. Matches rule 6 (progressive disclosure — the prompt carries metadata; content lazy-loads). Future stale-claim drift on the spec-count line is tracked at #336.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2 tasks
dep0we
added a commit
that referenced
this pull request
Jun 5, 2026
…336) (#338) The "Working methods" section claimed "4 published tags through v0.13.0, ~55 merged PRs, ~2.4k tests" — drifted out of sync with reality after the v1.0.0 release. Current counts verified empirically: git tag --list | grep ^v → 7 tags (v0.1, v0.9, v0.10-13, v1.0) gh pr list --state merged → 159 merged uv run pytest --collect-only → 3,326 tests Refreshed parenthetical to "7 published tags through v1.0.0, ~160 merged PRs, ~3.3k tests". The "no production rollback events" claim is preserved verbatim. Surfaced by the /ship pre-landing review on PR #337 (docs slim) and filed as #336 to keep that PR's scope narrow. Co-authored-by: Dan Powers <dep0we@gmail.com> Co-authored-by: Claude Opus 4.7 <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.
Summary
CLAUDE.mdhad grown to 88,265 chars — over Claude Code's 40k-char prompt budget. Slimmed to 29,887 chars (66% smaller) by extracting per-protocol detail into a newdocs/protocols-shipped.md.Matches rule 6 (progressive disclosure — the prompt carries metadata; content lazy-loads).
What survived
What got fixed inline
While editing the "Where things live" table, the adjacent line claimed "36 docs today, 32 locked + 3 drafts." Verified — actual is 35 docs (spec/23 was never assigned). 32 locked + 3 drafts = 35 ✓. One-line correction. Rest of the line was already accurate.
What was filed out-of-band (scope discipline)
Review trail
Test plan
uv run pytest --collect-only -q | tail -1→ 3,326 tests collected cleanly. Full suite NOT re-run: this is a markdown-only diff, no test loads or parses the changed files (verified viagrep -rn "CLAUDE.md\|CHANGELOG.md\|protocols-shipped" tests/). Honest accounting per [feedback_ship_end_to_end_no_shortcuts]: structural sanity check substituted for full re-run on a docs-only diff.wc -c CLAUDE.md→ 29,887 chars (under 40k budget)docs/protocols-shipped.mdexists and the in-CLAUDE.md pointer resolvesFile-by-file
CLAUDE.mddocs/protocols-shipped.mdCHANGELOG.md[Unreleased] → Documentation🤖 Generated with Claude Code
Co-Authored-By: Claude Opus 4.7 noreply@anthropic.com