Model-Drafted vs Human-Owned: A Contract for Generated Docs

说明与用途

使用所有权合同和检查脚本，确保模型生成的文档中没有未经人类签署的权威声明。

问题

Generated documentation can include authoritative language (guarantees, deadlines, contact paths) that no human has signed off on, creating unowned commitments.

结果

Docs are now generated with clear ownership boundaries, preventing accidental commitments and ensuring human review of any authoritative language.

工作流

• 1. Define ownership.json with files, human_owned, draftable, and authority_phrases.
• 2. Add HTML comment markers (docs-own) to each heading in the target Markdown file.
• 3. Run ownership_check.py in CI before invoking any doc generator.
• 4. The checker verifies all ids exist, human sections have signed_by, draftable sections lack authority phrases, and no unknown ids are present.
• 5. If any rule fails, the CI job fails, preventing generation of unowned authoritative text.

证据

The checker can parse it. Rendered Markdown ignores it.

来源

Fail if generated docs speak with unowned authority.

来源