Coder/deepseek-harness
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(budgets): ceilings carry at least 5% working headroom

Browse Source 
Exact-size ceilings turned every two-word wording fix into a gate
event. The policy amends to: a ceiling sits at least 5% above the
doc's current size (pre-rewrite) and keeps that margin when ratcheted
to target — routine edits pass, real growth still trips the gate.
Amended together in all four policy homes (docs/AGENTS.md § Budgets,
the doc-tiers RFC, the gate script's module comment, the skill's
ratchet rule) plus the manifest values, so prose and mechanics stay
consistent.
This commit is contained in:
Tianyi Cui
2026-07-04 17:20:18 +08:00
parent 5f21d4bf6c
commit cada16c701
5 changed files with 13 additions and 12 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
scripts/doc-budgets.manifest.json
View File

@@ -1,8 +1,8 @@
{
"AGENTS.md": 8134,
"docs/AGENTS.md": 982,
"docs/architecture.md": 3897,
"examples/AGENTS.md": 579,
"packages/AGENTS.md": 577,
"packages/README.md": 1856
"AGENTS.md": 8545,
"docs/AGENTS.md": 1050,
"docs/architecture.md": 4095,
"examples/AGENTS.md": 610,
"packages/AGENTS.md": 610,
"packages/README.md": 1950
}

7
scripts/verify-doc-budgets.ts
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