Conversation
CLAUDE.md measured 24516 bytes against the 16200-byte ceiling for a submodule agent doc, and 316 lines against the 300-line agent-doc shape rule the estate drift manifest declares. Five whole sections move into documentation/, byte for byte, each under the heading it already had: Status to documentation/status.md, Tech Stack to documentation/tech-stack.md, the attw gate to documentation/guardrail-attw.md, the PHI scanner to documentation/guardrail-phi-scanner.md, and the agent-instruction contract gate to documentation/guardrail-agent-notes-gate.md. Every heading stays in CLAUDE.md above a pointer at the file its body left for, so nothing is deleted and nothing is retitled. The pointers also keep every documentation/agent-notes.md anchor that travelled with a moved section, so the agent-instruction contract gate still finds a pointer at each archive section. CLAUDE.md is now 11816 bytes over 174 lines. No mapping, parser, fixture or published file is touched. Evidence: pnpm check:agent-notes, check:no-emdash, check:no-internal-refs, format:check, typecheck, lint and vitest are green, and every line of the previous CLAUDE.md is still present byte for byte either in the reduced file or in exactly one of the new files.
… relocation preambles Each new file opened with the section name wrapped in backticks that the name already carried, so the attw and Tech Stack headings rendered a broken code span. The relocated bodies are untouched.
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.
Spec:
pipeline/active/S0308-submodule-agent-doc-budgets/children/transform.mdin the umbrellarepository (parent spec
pipeline/active/S0308-submodule-agent-doc-budgets/spec.md).What this is
CLAUDE.mdmeasured 24516 bytes against the fleet ceiling of 16200 for a submodule agentdoc, and 316 lines against the 300-line agent-doc shape rule the estate drift manifest
declares. This change brings it back under both by splitting it, never by deleting from it.
Five whole sections move into
documentation/, byte for byte, each under the heading it alreadyhad:
## Statusdocumentation/status.md## Tech Stack (the shared @cosyte/* standard)documentation/tech-stack.md### The attw gatedocumentation/guardrail-attw.md### The PHI scannerdocumentation/guardrail-phi-scanner.md### The agent-instruction contract gatedocumentation/guardrail-agent-notes-gate.mdEvery heading stays in
CLAUDE.mdabove a short pointer at the file its body left for. Nothing isdeleted, nothing is retitled, and no mapping, parser, fixture or published file is touched.
CLAUDE.mdis now 11816 bytes over 174 lines.Why the pointers carry anchors
scripts/check-agent-notes.tsrule R5 refuses a##section ofdocumentation/agent-notes.mdthat nothing in
CLAUDE.mdpoints at. Three archive anchors travelled with## Statusand oneeach with the three guardrail subsections, so each pointer restates the anchors that left with its
section. The gate is green.
Evidence
pnpm check:agent-notesgreen (3 files opened, reconciled against 188 tracked).pnpm check:no-emdashgreen (185 tracked files, 188 filenames).pnpm check:no-internal-refsgreen (documentation/is out of that gate's scan surface by itsown stated boundary; the moved text carries decision-record citations that belong on the inside).
pnpm format:check,pnpm typecheck,pnpm lintgreen.pnpm testgreen (952 tests). Two conformance cases time out intermittently under full-suiteparallelism in the sandbox and pass on their own; they read no markdown.
CLAUDE.mdis still present byte forbyte, either in the reduced file or in exactly one of the new files, and that each moved block is
an unbroken run under its original heading.
pnpm pack --dry-runlists the same tarball contents as before (dist,README.md,LICENSE,CHANGELOG.md,package.json): nothing underdocumentation/is published, andscripts/build-docs-artifacts.shbuilds fromdocs-content/,src/,package.jsonandtsconfig.jsononly.