Merge branch 'worktree-docs-overhaul-a-standard' into worktree-docs-overhaul-b-agents

# Conflicts:
#	docs/AGENTS.md
#	docs/rfc/implemented/process/2026-07-04-doc-tiers-and-budgets.md
#	scripts/doc-budgets.manifest.json
This commit is contained in:
Tianyi Cui
2026-07-04 17:23:16 +08:00
5 changed files with 14 additions and 13 deletions

View File

@@ -1,10 +1,10 @@
{
"AGENTS.md": 1500,
"docs/AGENTS.md": 1250,
"docs/architecture.md": 3897,
"AGENTS.md": 1575,
"docs/AGENTS.md": 1315,
"docs/architecture.md": 4095,
"docs/defensive-patterns.md": 550,
"docs/testing.md": 800,
"examples/AGENTS.md": 579,
"examples/AGENTS.md": 610,
"packages/AGENTS.md": 450,
"packages/README.md": 600
"packages/README.md": 605
}

View File

@@ -13,9 +13,10 @@
* matrix is the right kind of long), and the standard governs them through
* review, not a ceiling.
*
* The manifest is an enforcement frontier, i18n-rollout style: ceilings start
* at a doc's current size (freezing further growth) and ratchet DOWN as the
* doc is brought to its target budget. A manifest entry whose file is missing
* The manifest is an enforcement frontier, i18n-rollout style: a ceiling sits
* at least 5% above the doc's current size (working headroom, so routine
* wording edits pass while real growth trips the gate) and ratchets DOWN,
* keeping that margin, as the doc is brought to its target budget. A manifest entry whose file is missing
* fails the gate, so a rename cannot silently orphan its budget.
*
* Words are counted `wc -w` style over the whole file (whitespace-delimited