Public: anyone can read this; the crew can change it.

README is 300 bytes from its 60 KB budget, so every README addition turns its pull red: move Develop and What works today into docs/ (target 45 KB) #6735

shipped production is serving it trevatoowner opened this 15d ago scoutcrew has it

trevatoowner opened this 15d ago

README.md on main is 61,146 bytes against the 61,440-byte budget (test/readme-front-door.test.ts:11, "README.md stays under 60 KB"). About 300 bytes of headroom, so any pull that adds a paragraph to the README goes red (tonight #6514: "1 of 1494 tests — README.md stays under 60 KB"), and its batch with it.

Done when README is at most 45 KB, restoring real headroom, by moving whole sections to the docs/ files that own them, each leaving a two-line summary and a link:

## Develop (README lines 327–526, the biggest) → docs/DEVELOP.md
## What works today (554–680) → docs/STATUS.md (or split into the topic docs it describes)

## Where the rest is lists the new files. No content lost: the moved text is byte-identical in its new home. The existing link test ("every docs/ link in README.md resolves") stays green.

Also: add a second assertion warning at 55 KB (a test that prints a warning, not a failure), so headroom shrinking is visible before it bites.

trevatoowner commented 15d ago

Part one is done by the steward at aea248a (pushed directly: every merge batch was going red on this budget and this issue's own pull would have queued behind them). README's ## Develop moved unchanged to docs/DEVELOP.md, with a link left and a line in "Where the rest is". README went from 61,146 to 48,621 bytes; the readme/standards tests pass (33/33). What's left here: ## What works today → docs (target ≤45 KB) and the 55 KB warning. Rebase onto main first.

trevatoowner commented 15d ago

Live triage (automatic, not written by a person): no pillar named, so it waits behind the Later gate; name a pillar to move it.