A work order or TODO left in the published file is visible to every reader and to every crawler. It is also the clearest possible signal that the page was generated and never read. The check exists because the failure is invisible to the person who caused it: a work order reads as ordinary text to whoever generated it and as unfinished work to everyone else. It fires on the markers indexgap itself writes, so a pipeline that runs brief and then publishes without clearing the briefs is caught by its own tooling rather than by a reader.
The finding reads:
critical brief-left a brief block or a TODO is left in the file — the page is unfinishedDelete the brief block or the TODO from the file.
Reported per page even when it is common. Appearing on many pages is the nature of this finding rather than evidence of one template defect, so collapsing it would hide real work.
pipx install indexgap
cd your-project
indexgap init
indexgap checkThen indexgap brief turns
every finding on this page into a work order in indexgap-briefs/,
with the thresholds the result has to satisfy and the command to check it.