docs: regenerate CLAUDE.md — clear 40k warning + purge 'precision that rots'#606
Merged
Conversation
Trim CLAUDE.md from 40,923 → 38,948 chars (clears the 40k "Large CLAUDE.md will impact performance" startup warning). Staleness fixes: - skills count 112 → 115 (ls skills/ | wc -l) - commands count 23 → 24 (ls commands/ | wc -l) Compression (no operational facts lost — detail stays in the linked learning/reference files): - "Close the loop" convention: tightened prose, kept both shapes + #591/#593/#586 - "File ACE issues mid-run": tightened - Improvement-cycles state-consolidation history → pointer - dump-atom-schemas apostrophe gotcha → one-liner + learning link - Connect-Labs MCP gotcha → deduped against Layout entry - Removed commcare-form-patch deletion history (lives in git) - Cold-boot failure-class list trimmed Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
jjackson
changed the title
jjackson
added a commit
that referenced
this pull request
May 31, 2026
docs: purge 'precision that rots' from CLAUDE.md (follow-up to #606)
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.
Why
Session startup warned
Large CLAUDE.md will impact performance (40.7k > 40.0k). The culprit is purely the projectCLAUDE.md(40,923 chars); the global one is 936 chars and plugins/run-state don't count. This started as a size trim and became a structural cleanup after the question "do file counts even belong in here?"Result
CLAUDE.md: 40,923 → 37,066 chars (210 lines, structure preserved). ~2.9k headroom under the 40k line.Two passes
1. Staleness + compression (1st commit): tightened the longest convention bullets and collapsed history parentheticals to pointers — no operational facts lost.
2. Kill "precision that rots" (2nd commit) — the higher-leverage fix, removing the cause of recurring doc-regen churn:
ls … | wc -lpointer. A cardinality is not actionable for an agent and rots on every add.docs/atom-schemas.md.0.5.16,0.7.0,0.7.1,0.9.4,0.11.3,0.13.34/.53/.116/.202/.375, dates) → purged. Git/CHANGELOG owns "which version introduced X"; the agent only needs the rule.ace-mobileLayout bullet; precondition cold-boot call-chain) → collapsed to pointers —playbook/integrations/mobile-integration.mdalready covers both in full (verified by grep).Kept on purpose (load-bearing, not decoration)
orchestrator-reference.mdexplicitly names CLAUDE.md as its canonical source; it's stable, enumerable reference.Audit notes
test -ethis session — 0 broken.grep -E '0\.(5|7|9|11|13)\.[0-9]+'→ none).No known Nova upstream bugsstill holds (open pdd-to-deliver-app: skill-prescribed case-create entity_id '/data/case/@case_id' is rejected by Nova validate_app #586 is an ACE-side skill-prescribedentity_id, not a Nova bug).🤖 Generated with Claude Code