make wordcount budget guidance clearer and dedup docs

This commit is contained in:
Turtle
2026-07-10 00:20:35 +08:00
parent f77174f13a
commit c60eb87860
2 changed files with 9 additions and 7 deletions

View File

@@ -38,9 +38,7 @@ Compression discipline: every load-bearing rule survives — as one to three lin
## When verify-doc-budgets goes red
1. Relocate: does the new content belong in a linked home (RFC, postmortem, cookbook, README) with a one-line pointer left behind?
2. Condense: can existing prose in the doc pay for the addition — a story compressed to its rule, a duplicate converted to a link?
3. Only then raise the ceiling: edit `scripts/doc-budgets.manifest.json` and justify the raise explicitly in the PR description. After any rewrite that shrinks a budgeted doc, ratchet its ceiling down to the new size plus working headroom (at least 5%) in the same PR.
Apply the ordered relocate-condense-raise policy in [docs/AGENTS.md](../../../docs/AGENTS.md); this skill only supplies the workflow probes above.
## Validation and PR hygiene