Fail the Docs Build When CLI Examples Drift From a Fixture Ledger
python
dev.to
Generated command documentation fails in review when example lines are invented rather than recorded from a controlled run. A fixture ledger should freeze the argv list, the exit status, and a hash of stdout before any model writes surrounding prose. The drafting model may explain flags, suggest section order, and propose cautionary notes, but it must not own the recorded commands. Reviewers then accept or reject the page by comparing fenced examples with the ledger, rather than by trusting the