| name | loop-pr |
| description | Watch one existing GitHub pull request, validate and address review comments, repair scoped CI failures or clear conflicts, request fresh review after each changed head, and stop when merge-ready or blocked. Use when the user asks to babysit, monitor, fix, or carry a PR through review. |
Loop PR
Keep one PR moving without making the user relay comments between GitHub and Codex.
Workflow
- Resolve the PR and read repository instructions, scope, checks, active unresolved threads, latest review state, mergeability, and head SHA.
- Record the head SHA, active findings, check state, cycle count, and last meaningful activity.
- When the head is new, create a fresh independent review task. Give it the original intent, acceptance criteria, diff, and verification evidence, not the maker's reasoning.
- When valid findings or PR-caused CI failures exist, create a fresh remediation task on the PR branch. Require scoped fixes, behavioral and repository checks, commit, and push.
- Re-observe GitHub after every task. A new head triggers a new review. Do not reuse the maker or previous checker.
- Declare merge-ready only when required checks pass, no actionable independent finding remains, no unresolved GitHub thread or active change request remains, scope is valid, and the PR is mergeable.
- Stop after three failed remediation cycles, repeated unchanged failures, conflicting intent, unrelated required work, missing permission, or destructive action.
- Merge only when the user requested it. Otherwise return a merge-ready receipt.
Poll through task wakeups or automations, not shell sleeps. Silence is not approval.
