Sign the Sentences, Not the PR: An Approval Ledger for Model-Drafted Doc Blocks

Description and use

The workflow ties each model‑drafted sentence to a human signature via hashing; any change invalidates the signature, forcing re‑approval.

PR approvals can outlive the text they approve, allowing model‑rewritten sentences to remain unreviewed.

The workflow ensures that any change to a model‑drafted sentence requires a fresh human signature, preventing stale approvals.

Mark ownership boundaries with HTML comments in the source file.
Draft the file with a model under a restricted instruction that only rewrites model‑owned blocks.
Run a pre‑commit/CI checker that hashes each model‑drafted block and compares it to a JSON ledger of approved hashes.
If a hash differs, the checker fails, prompting a new human approval for the changed block.

Most documentation reviews approve a pull request, not a sentence.

The artifact is a ~90-line Python checker that runs in pre-commit and CI.

Wrap each unit you want to attribute in an HTML comment pair, and keep the body plain Markdown so the page still renders anywhere.