Merge pull request 'chore(scripts): promote index-coverage checker; document bundle gates' (#31) from chore/29-kb-coverage-tooling into main

omp-docs/references/okf-maintenance.md

@@ -8,7 +8,7 @@ tags:
   - documentation
   - best-practices
   - unverified
-timestamp: 2026-01-15
+timestamp: 2026-10-19
 ---
 
 # OKF Bundle Maintenance
@@ -139,6 +139,27 @@ git status --short                            # What is uncommitted
 | `index.md` count differs from file count | Always | Fix immediately |
 | `log.md` has no entries for 30+ days | Context-dependent | Normal if no changes made |
 
+
+---
+
+## Automated Gates (this bundle)
+
+Two mechanical checkers live in `scripts/`; both exit non-zero on violations.
+Run both before committing any `omp-docs/` change; `tests/kb-lint.bats` pins
+their behavior.
+
+```bash
+bash scripts/kb-lint.sh omp-docs         # OKF conformance
+python3 scripts/kb-coverage.py omp-docs  # index coverage doctrine
+```
+
+- **kb-lint** — OKF v0.1 rules: non-empty `type` frontmatter on every
+  non-index file, no frontmatter on `index.md`, resolvable wikilinks and
+  relative links, reserved names (`index.md`/`log.md`), `YYYY-MM-DD` log
+  headings.
+- **kb-coverage** — the AGENTS.md anti-rot mechanism: every directory has an
+  `index.md`, and that index links every sibling file and subdirectory.
+
 ---
 
 ## See Also