Repository navigation
Curate the over-budget reference docs: COMMANDS.md, SKILLS.md, ENVIRONMENT.md #146
Description
Three reference docs are over the 10,000-token per-doc budget, and six more are near it. Measured with measure-context.sh --exact --no-write at beda65d, 2026-10-19:
| Doc | Tokens |
|---|---|
docs/COMMANDS.md |
10378 (over) |
docs/SKILLS.md |
10059 (over) |
docs/ENVIRONMENT.md |
10014 (over) |
docs/contracts/content-replicate-issuer-contract.md |
9893 |
docs/contracts/content-fetch-outcome-reference.md |
9840 |
docs/CONVENTIONS.md |
9745 |
docs/contracts/replicator-boundaries.md |
9726 |
docs/contracts/content-fetch-issuer-contract.md |
9723 |
docs/STREAMS.md |
9285 |
None of the epic #135 children caused these, but they have already shaped work:
- Apply FetchPolicyState.generation only if newer #136 put a new grep in POLITENESS.md rather than in COMMANDS.md.
- After F1: state the fetch-policy producer as Archiver, retire the "until F1" wording #144 has to split
replicator-boundaries.mdbefore it grows.
Proposed: a curating-context run with --file on each over-budget doc, demoting or splitting the way #140 did for DEPLOYMENT.md (10889 → 7570, with Memory protection moved to its own doc). Record per-file telemetry. Then decide whether the near-budget contract docs need splitting before their next edit.
Done when: all three are under 10000 exact, with no dead links or anchors, no new orphans, and a no-loss pass for each.
Activity
#146 docs: CR 9 — DEPLOYMENT.md's preamble names the variables it now…
#146 docs: CR 10 — the politeness pointer names the live-apply greps too
#146 chore: CR 11 — doc-check advice routes SOCRATICODE_SPEC to SOCRA…
#146 chore: CR 10 — amend the COMMANDS.md row to the corrected tree (…
gregoryfoster commentedon Oct 19, 2026
Shipped in #147 (
beda65d..d46cb16, fast-forwarded to main).### Inspecting the stream.init-socraticodere-run checklist → SOCRATICODE.md's repo-specific notes.REPLICATOR_REDIS_FLOOR_TIMEOUT,REPLICATOR_REDIS_FLOOR_WAIT,REPLICATOR_ALLOW_ANY_CHECKOUT) → DEPLOYMENT.md## Environment Variables.CR 1commits) and a CR round (findings 9–11, all fixed). Full suite: 1421 passed, 1 skipped.Near-budget docs, the "then decide" item: split each one just before its next edit that adds content, not now. The four contract docs have 100–280 tokens of headroom, and #144 already has to split
replicator-boundaries.md. COMMANDS.md is still near budget at 9521. Its next block to move is the ~1400-token broker-permissions history, but no doc has room for it yet: INFRASTRUCTURE.md would land at about 9970.Follow-up:
codebase_update, because four SocratiCode manifest descriptions changed.