docs(learnings): tighten — archive 13 cold lessons - #1127
Merged
Conversation
Operator-gated /lessons-learned tighten pass. The MEMORY.md projection was 24,379 B — 21 bytes under the 24,400 hard refuse cap, where the next lesson written would have made render-index refuse outright. Archived the 13 coldest eligible lessons (query hits 4–26), all repo-root. Archive is a move, not a delete: every slug stays queryable under docs/learnings/archive/ and inbound [[wikilinks]] still resolve. Deliberately NOT struck: the six highest-hit eligible lessons (29–118 hits), including readme-undersell-guard-couples-doc-prose-to-true-slot-count (118 hits) — the tool's default cutIndex included them only because eviction alone cannot reach the 17,000 B advisory line, and dropping the most-queried lessons out of agent prefetch to reclaim ~160 B each is a bad trade. Projection: 24,379 B / 132 lines → 22,156 B / 119 lines. Still above the 17,000 B advisory: eviction can free at most 3,238 B against a 7,879 B goal. The remaining lever is description compression — summary cells are 15,285 B of the file (63%), with 59 cells at or above 150 B. Redaction lint clean over the whole directory. Co-Authored-By: Claude Fable 5 <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
2 participants
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.
Operator-gated
/lessons-learned tightenpass.Why now
The
MEMORY.mdprojection was 24,379 B — 21 bytes under the 24,400 hard refuse cap. The next lesson written would have maderender-indexrefuse outright.What changed
Archived the 13 coldest eligible lessons (query hits 4–26), all repo-root. Archive is a move, not a delete — every slug stays queryable under
docs/learnings/archive/and inbound[[wikilinks]]still resolve.What was deliberately NOT struck
The tool's default
cutIndexwas the entire 19-entry eligible list — includingreadme-undersell-guard-couples-doc-prose-to-true-slot-count(118 query hits),plan-can-name-a-nonexistent-lens-even-in-an-anti-drift-plan(70), andred-team-drift-guard-spine-probes-are-lead-run-prose-not-spine-array-entries(49). It proposed them only because eviction alone cannot reach the advisory line at all. Dropping the three most-queried lessons in the corpus out of agent prefetch to reclaim ~160 B each is a bad trade, so the operator approved the cold prefix only.Known residual
Still above the 17,000 B advisory line. Eviction can free at most 3,238 B against a 7,879 B goal — the eligible set is floor-bounded and simply cannot get there.
The remaining lever is description compression: summary cells are 15,285 B of the file (63%), with 59 cells at or above 150 B. Capping cells near 80 B would free ~5,971 B, which combined with eviction clears the advisory. That is a separate pass over ~59 lesson files.
🤖 Generated with Claude Code