Conversation
…r their byte budgets CLAUDE.md is always read and measured 23154 bytes against a 16200 ceiling; README.md measured 22693 against 22400. Seven whole sections move out of CLAUDE.md and two out of README.md, byte for byte and under their existing headings, into documentation/: - documentation/repo-gates.md: the docs sidebar, the pre-commit PHI scanner, the em-dash brand gate, branch protection and the attw gate - documentation/packaging.md: the published package and the FHIR hole, hard runtime deps - documentation/convert-and-map-codes.md: cosyte convert and cosyte map-codes No heading is renamed and no line is deleted. Each reduced document keeps its heading and carries a pointer at the copy, so every heading stays reachable from the document that replaced it. Links inside moved text are re-based by exactly one directory, so nothing points outside this repo. package.json files is untouched and npm pack --dry-run lists the same four entries as before, so the published tarball is unchanged. CLAUDE.md now measures 11862 bytes over 174 lines and keeps all five required headings; README.md measures 21186 bytes.
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
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.
Spec:
pipeline/active/S0308-submodule-agent-doc-budgets/children/cli.mdin the umbrella.What
CLAUDE.mdis always read and measured 23154 bytes against a 16200 byte ceiling.README.mdmeasured 22693 against 22400. Over budget is a design signal, so the remedy is to split, never to
raise the number and never to delete a line.
Seven whole sections leave
CLAUDE.mdand two leaveREADME.md, byte for byte, under their existingheadings, into
documentation/(the directory this repo's own agent doc already names foragent-notes.mdand its decision records):documentation/repo-gates.md: the docs sidebar and the IA spine, the pre-commit PHI scanner, theem-dash brand gate, branch protection, and the
attwgate.documentation/packaging.md: the published package and the FHIR hole, and hard runtime deps.documentation/convert-and-map-codes.md:cosyte convertandcosyte map-codes.Each reduced document keeps the heading and carries a short pointer at the copy, at the point the
section left. No heading is renamed. Links inside moved text are re-based by exactly one directory,
so every one still resolves and none points outside this repo.
Result
CLAUDE.mdREADME.mdCLAUDE.mdis 174 lines and still carries all five headings the estate baseline requires(
## Project,## Status,## Tech Stack,## Engineering Guardrails,## Standing disciplines).Evidence
is still reachable from the document that replaced it. Prints nothing for both paths.
outside this repo, no missing target. Prints nothing.
pnpm test: 777 passed, 41 files. The suite is whyredactstayed on the front page:test/docs-content.test.tspins that matrix toREADME.md, and the first draft that moved it red.pnpm check:agent-notes: OK, 26 qualified pointers from 4 files, all resolving.pnpm check:no-emdash,pnpm check:no-internal-refs,pnpm format:check,pnpm phi-scan: OK.npm pack --dry-runbefore and after lists the same four entries (CHANGELOG.md,LICENSE,README.md,package.json), both withdist/unbuilt.package.jsonfilesis untouched anddocumentation/is outside it, so the published tarball does not change.