Anchor Coverage: A CI Gate for Docs a Model May Draft but Never Own

说明与用途

CI 门控确保 AI 生成的文档文本可追溯到机器可读的事实，降低人工审核成本。

问题

Generated documentation prose can contain outdated or untraceable facts, leading to human review costs that do not scale.

结果

The gate ensures drafted prose is traceable to machine‑readable facts, reducing human review effort and preventing stale documentation.

工作流

• Split docs changes into Extract, Draft, Own lanes
• Extract lane pulls facts from existing sources and is script‑owned
• Draft lane allows model output only within delimited blocks
• Own lane contains human commitments and is not model‑editable
• Run anchor_gate.py against docs and claims.json
• Anchor_gate.py parses draft blocks, extracts anchors, and checks against claims
• Fail build if any draft paragraph lacks a matching claim or has too many orphans

证据

The gate resolves anchors against claims.json and refuses naked numbers.

来源

Split every documentation change into three lanes before any model sees the file.

来源