Mark Doc Sections as Draftable, Review-Gated, or Human-Only

Description and use

The workflow enforces clear ownership, prevents accidental model generation of sensitive content, and reduces review friction by automating permission checks.

Problem

Generated documentation often contains errors because the wrong author or model writes sensitive sections, leading to tone disputes and missing ownership.

Outcome

The workflow enforces clear ownership, prevents accidental model generation of sensitive content, and reduces review friction by automating permission checks.

Workflow

• 1. Create docs/ownership.yaml with path, right, owner_role, reviewer, evidence_glob entries.
• 2. Run tools/check_ownership.py to validate the ledger against Markdown heading paths.
• 3. If validation passes, proceed to generate or review content per the rights defined.
• 4. For draftable sections, provide evidence files so the model can emit full prose.
• 5. For review_gated sections, the model emits outlines and facts but not final recommendations; human reviewers approve.
• 6. For human_only sections, the body is stripped from prompts and a signature must exist before publishing.