Give Every Heading a Restate or Commit Lane Before Generation

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

Внедрение проверки речи‑акта в CI позволяет отделить фактические описания от обязательств в документации, генерируемой ИИ, повышая надёжность и снижая юридические риски.

Задача

Documentation generated by AI often mixes factual restatements with vendor commitments, leading to unverified promises and legal risk.

Результат

The workflow reduces manual review effort, prevents accidental promises in AI‑generated docs, and maintains legal compliance by keeping commitments human‑owned.

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

• Define five speech‑act labels (DESCRIBE, EXAMPLE, PRESCRIBE, PROMISE, WARN).
• Create a heading‑permission YAML map that assigns each heading to a lane (restate or commit).
• Run the speech‑act filter script on model drafts before merge; non‑zero exit blocks the PR.
• Reviewers focus on commitment headings while the restatement headings are auto‑generated.
• Iterate on the permission map and forbidden verb list based on gate failures.

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

Models are statistically good at turning a schema into a parameter table or an example body. They are not a source of authority for promises that customers will quote during an incident.

Источник