Review Public Docs

---
name: review-public-docs
description: Review the shipped prose, site pages and release notes before a release. Load by path.
---

# Review public docs

Run before preparing a release. Read the release allowlist, then split the
shipped prose, site pages and release notes draft into about five parts. Include
the relevant source files with each part.

Give each part to a fresh reviewer that has not seen another review. Ask it to
check claims in this order: code and checks, release notes, then the inventory.
Look for stale terms, contradictions, wrong counts, broken references and
unsupported claims. A reviewer must confirm each finding in the code or check
before reporting it. Otherwise it reports the concern as unconfirmed.

Collect the reports in `.agents/tmp/public-docs-review/` and combine confirmed
findings into one list for the maintainer. A release waits until each finding
is fixed or the maintainer accepts it. Keep accepted findings and their reasons
with the review record.

## The printout

One line for each finding, most serious first:
`file:line` | kind (stale, contradiction, count, reference, unsupported) |
what the code or check shows, with its `file:line` | the fix in one line |
confirmed or unconfirmed.

Under the list, give the count of each kind and the findings the maintainer
already accepted, with the reason. This review reports and changes nothing.

## Done when

Every part has had one fresh reviewer, every confirmed finding is on the list,
and the maintainer has fixed or accepted each one before the release is
prepared.