docs(architecture): trim architecture.md under the 150k-char context limit#1344
Open
dolho wants to merge 1 commit into
Open
docs(architecture): trim architecture.md under the 150k-char context limit#1344dolho wants to merge 1 commit into
dolho wants to merge 1 commit into
Conversation
…limit architecture.md had grown to ~156.7k chars (on dev), past the 150k soft limit Claude Code warns about when auto-loading it each session (it's `@`-imported by CLAUDE.md). Over the limit the file risks silent truncation and eats a large slice of the context window every session. Compressed the densest Cross-Cutting Subsystem narratives, the migration and non-root-container invariants (#3/#17), a few catalog/endpoint rows, and the longest frontend UI prose — preferring summary + pointer where a dedicated `feature-flows/` doc already owns the deep detail (the doc's own editorial rule). Result: 156.7k → 149.3k chars (~4.8% smaller). No facts dropped: every issue tag, field name, default, and error-string is preserved; protected SQLite DDL (tracked by /validate-schema) untouched; heading/code-fence/table counts unchanged; all 12 added flow-doc links resolve. Related to the over-limit warning surfaced in Claude Code. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
|
Resolve by running |
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
docs/memory/architecture.mdhad grown to ~156.7k chars (ondev), past the 150k soft limit Claude Code warns about. The file is@-imported byCLAUDE.md, so it's auto-loaded into context every session — over the limit it risks silent truncation and eats a large slice of the context window each turn.What
Compressed the densest prose, preferring summary + pointer wherever a dedicated
feature-flows/doc already owns the deep detail (the doc's own editorial rule #2):Result
156.7k → 149.3k chars (~4.8% smaller) — clears the warning.
Safety
/validate-schema) untouched.dev(68 / 58 / 32).feature-flows/*.mdlinks resolve.🤖 Generated with Claude Code