docs: rebalance prose cleanup and add trimming skill

2026-07-13 23:27:00 +08:00
parent fcdc318dda
commit 148046b9c8
392 changed files with 2801 additions and 1754 deletions
--- a/scripts/verify-doc-budgets.ts
+++ b/scripts/verify-doc-budgets.ts
@@ -1,7 +1,9 @@
 /**
 * Enforce `wc -w`-style ceilings from `scripts/doc-budgets.manifest.json`.
 * Missing files and invalid ceilings fail; `--list` reports current usage.
- * Ceiling changes remain reviewable manifest edits.
+ * Only listed standing docs are budgeted. Ceilings ratchet down with at least
+ * 5% headroom; raising one requires the justification defined in
+ * `docs/AGENTS.md`.
 */

 import { existsSync, readFileSync } from 'node:fs'