Use GitHub review metadata plus the local checkout.
Workflow:
- Fetch PR metadata and review comments. Confirm that the local branch is at the PR head SHA.
- Check each comment against the code at the PR head before any change.
Trace the call sites for a "this can fail" claim. Give each check an
evidence level from
docs/development/quality-gates.md. - Sort each comment into one group:
- Act on: the check shows the problem. Only these comments change code.
- Consider: valid, but it has a cost or changes scope. Ask the maintainer.
- Noted: true, but no change is necessary now.
- Dismissed: wrong, a preference, or missing context. Give one reason.
- Implement the Act on fixes, one comment at a time.
- Run the smallest relevant validation.
- Draft one reply per thread for the maintainer to approve. Never post a reply or resolve a thread. Lead with the fix and its commit. Thank a contributor in one short sentence.
- Summarize each group, with the reason for each Dismissed comment.
Follow repo conventions from AGENTS.md: no AI attribution, signed commits when committing.