| name | review-loop |
| description | Use only when the user explicitly asks to review, fix, and re-review a branch or PR until clean, or when an active ship/checkpoint workflow invokes it — "run the review loop", "review and fix until it passes", "loop review on this PR". |
| argument-hint | [PR URL|branch] |
Review Loop — review → fix → re-review until clean
Proceed only when the surrounding user request explicitly asks for the loop (including
direct /tgc-skills:review-loop invocation) or tgc-skills:ship/tgc-skills:checkpoint
invokes it. It commits fixes and pushes once, so stop without that authorization.
Review the branch diff with independent agents, fix legitimate findings, and repeat
until clean or a stop condition is reached. Never merge the PR.
Keep the loop out of the main context
Create STATUS=$(mktemp "${TMPDIR:-/tmp}/tgc-review-loop.XXXXXX") and tell the user
that progress is visible there. Then launch one general-purpose subagent with the repo
path, optional PR/branch argument, status path, and the complete workflow below. The main
context manages only the dispatch and final report. Subagents may start in the
background; explicitly wait for this one to finish before returning or letting a parent
workflow report completion.
Subagent workflow
Setup and heartbeat
-
Resolve the local nameWithOwner, current branch, and GitHub default branch. Stop if
the current branch is the default branch. Require a supplied branch argument to equal
the current branch. If a PR is supplied or detected, require its URL repository to
match nameWithOwner and its headRefName to match the current branch. Stop on any
mismatch. Use its ; without a PR, use the default branch.
