CalvinBackup/gstack
1
0 Fork 0
mirror of https://github.com/garrytan/gstack.git synced 2026-10-01 00:49:39 +02:00
Code Issues Packages Projects Releases Wiki Activity

docs: pin exact guard semantics for the context-budget ratchet in CLAUDE.md

Browse Source 
Doc-review finding: "a third enforced ceiling" undercounted the guard
family (skill-size-budget floors and parity ratios also watch these
ledgers, relatively). Rephrased to match the ratchet test's own header:
absolute ceilings vs relative floors/ratios.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
Garry TanandClaude Fable 5 committed 2026-08-25 03:33:22 +00:00
1 parent 21f44ff77a
commit 83de4518c5
1 file changed
+7 -6
Download Patch File Download Diff File Expand all files Collapse all files
CLAUDE.md
+7 -6
View File
@@ -226,12 +226,13 @@ conversation. The failure message carries the re-measure + ratchet protocol.
tree (always-on vs per-invocation, `--diff`, `--budget`; `--exact` opts into the tree (always-on vs per-invocation, `--diff`, `--budget`; `--exact` opts into the
real tokenizer and POSTs file text to api.anthropic.com with an egress receipt). real tokenizer and POSTs file text to api.anthropic.com with an egress receipt).
A third enforced ceiling is the context-budget ratchet: The context-budget ratchet (`test/context-budget-ratchet.test.ts`, free, runs
`test/context-budget-ratchet.test.ts` (free, runs in `bun run test`) grades the in `bun run test`) pins ABSOLUTE ceilings on two more ledgers: the always-on
two ledgers the other guards don't cover — the always-on FULL-frontmatter FULL-frontmatter aggregate (catalog-budget counts only name+description) and
aggregate and each skill's per-invocation eager tokens (SKILL.md + forced-read each skill's per-invocation eager tokens (SKILL.md + forced-read references —
references) — against `test/fixtures/context-budget.json`. A skill that grows size floors and parity ratios guard these relatively, not absolutely), graded
past its ceiling fails; a new skill fails until it's consciously budgeted. For against `test/fixtures/context-budget.json`. A skill that grows past its
ceiling fails; a new skill fails until it's consciously budgeted. For
legitimate growth or a landed reduction, re-run legitimate growth or a landed reduction, re-run
`bun test/helpers/capture-context-budget.ts` and commit the refreshed fixture `bun test/helpers/capture-context-budget.ts` and commit the refreshed fixture
in the same commit, so ceilings ratchet down and every win is locked. in the same commit, so ceilings ratchet down and every win is locked.