Skip to main content

​
ISSUE-FORMAT — the digest issue filed by docs-sync

One issue per audit run, on mnfst/docs, label docs-sync plus one label per finding category present. No findings = no issue = no noise.

​
Title

Docs audit — <date> (PRs #<from>–#<to>)

​
Body structure

Categories: OBSOLETE · INTERNAL-LEAK · WRONG · MISSING-CASE · IMAGE. IMAGE findings have no options; they say where the image goes, what it must show, and why that spot (Seb produces the images elsewhere).

​
Iron rules

  • Every finding carries BOTH sides of the evidence (doc sentence + code/PR reference). A finding without verifiable evidence does not ship.
  • Options, never decisions. The agent may recommend (“option 2 recommended because…”) but never presents a single path.
  • Findings previously rejected by Seb (see memory) are not re-raised unless the platform changed again on that exact point — then the finding says so explicitly.