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

# Conflicts:
#	scripts/doc-budgets.manifest.json

scripts/doc-budgets.manifest.json

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

scripts/verify-doc-budgets.ts

@@ -46,11 +46,13 @@ const rows: string[] = []
 
 for (const [path, ceiling] of Object.entries(manifest)) {
   if (!Number.isInteger(ceiling) || ceiling <= 0) {
+    rows.push(`BAD   ${'—'.padStart(6)} / ${String(ceiling).padEnd(6)} ${path}`)
     failures.push(`${path}: ceiling must be a positive integer, got ${ceiling}`)
     continue
   }
   const abs = resolve(root, path)
   if (!existsSync(abs)) {
+    rows.push(`MISS  ${'—'.padStart(6)} / ${String(ceiling).padEnd(6)} ${path}`)
     failures.push(`${path}: budgeted file does not exist (renamed or deleted? update scripts/doc-budgets.manifest.json in the same change)`)
     continue
   }