A Handoff Log for Model-Drafted Docs: Two Lanes and a Script That Counts Who Wrote What

Описание и применение

Внедрение журнала передачи, разделяющего контент на «draft» и «human» слои, позволяет отслеживать, кто и как проверил каждую часть документации, повышая её надёжность.

Задача

Documentation pipelines often fail because the model’s output is not traceable to who authored or verified each section, leading to unchecked claims such as rate limits.

Результат

The workflow produces a handoff log that enforces lane rules, tracks evidence, and surfaces violations, improving documentation reliability.

Рабочий процесс

• Freeze the outline before writing any prompt.
• Build a bounded evidence pack per section.
• Draft only the draft‑lane sections with supporting commands.
• Write the human‑lane sections from scratch.
• Log each section in the same CSV before the sprint closes.
• Run the report and read the violations before the totals.

Доказательства

Most documentation pipelines fail not because the model writes badly, but because nobody records who was allowed to write which part.

Источник

The lane rule is the entire design; the script exists only to make the rule visible and to stop the log from quietly drifting into fiction.

Источник

The script below is plain Python 3 with only the standard library, small enough to audit in one sitting.

Источник