Finding (wiki-audit 2026-08-05, axis: structure)
wiki-lint check 2 ("don't/never/avoid directive outside an Instead of table → error") does not match corpus practice: a mechanical sweep found 147 prohibition phrases in directive lines, yet sampling shows essentially all are decision-table rows that pair the prohibition with its replacement action and mechanism in the same cell (e.g. | 400/401/403/404/422 | Never retry — the request itself is wrong; the same bytes fail again |). Zero true violations (bare prohibition with no replacement) were found.
Evidence
node .claude/tmp/lint-sweep.js (see plans/wiki-audit/findings/structure.md): C2-prohibition-review = 147, all other mechanical checks (frontmatter, ids, related-links, index coverage, vague qualifiers, body size, staleness, sourcing) = 0 across 141 pages / 13 indexes.
Proposed fix
Refine AGENTS.md rule 3 + wiki-lint check 2 to: "a prohibition must be paired with its replacement in the same row/sentence, or live in Instead of". This makes the check mechanically enforceable and removes 147 rows of permanent manual-review noise. Schema-layer change → owner approval required.
Finding (wiki-audit 2026-08-05, axis: structure)
wiki-lintcheck 2 ("don't/never/avoid directive outside anInstead oftable → error") does not match corpus practice: a mechanical sweep found 147 prohibition phrases in directive lines, yet sampling shows essentially all are decision-table rows that pair the prohibition with its replacement action and mechanism in the same cell (e.g.| 400/401/403/404/422 | Never retry — the request itself is wrong; the same bytes fail again |). Zero true violations (bare prohibition with no replacement) were found.Evidence
node .claude/tmp/lint-sweep.js(see plans/wiki-audit/findings/structure.md): C2-prohibition-review = 147, all other mechanical checks (frontmatter, ids, related-links, index coverage, vague qualifiers, body size, staleness, sourcing) = 0 across 141 pages / 13 indexes.Proposed fix
Refine AGENTS.md rule 3 + wiki-lint check 2 to: "a prohibition must be paired with its replacement in the same row/sentence, or live in
Instead of". This makes the check mechanically enforceable and removes 147 rows of permanent manual-review noise. Schema-layer change → owner approval required.