# Iterate Pr

> Iteratively commit, push, and address PR feedback until CI passes and comments are resolved. Use this skill when the user wants to get a PR to a mergeable state, fix CI and address review comments in a loop, or says things like 'iterate on my PR', 'make this PR pass', 'fix everything on the PR', 'get this PR ready to merge', or 'keep going until CI is green'. Use when this capability is needed.

- Skill: `tomevault-io/iterate-pr` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/iterate-pr`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/iterate-pr/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/iterate-pr

---


# Iterate PR

Autonomously iterate on a pull request until CI checks pass and all comments are resolved. Each iteration runs in a fresh subagent.

## Arguments

- `$ARGUMENTS` - Maximum iterations (default: 3)

## Instructions

### Step 1: Initialize

Parse max iterations from `$ARGUMENTS` (default: 3). Set iteration counter to 0.

### Step 2: Check State

Get the PR for the current branch:

!`gh pr view --json number,url,headRefName,statusCheckRollup 2>/dev/null || echo "NO_PR"`

**If no PR exists:** Proceed to Step 3 (first iteration will create one).

**If PR exists:** Get unresolved comments data:

!`bash "${CLAUDE_PLUGIN_ROOT:-.agents}/skills/unresolved-pr-comments/scripts/unresolvedPrComments.sh" 2>/dev/null`

Parse the JSON output and evaluate exit conditions.

**If any CI checks are still PENDING, QUEUED, or IN_PROGRESS:** Proceed to Step 3 regardless of comment count. Automated reviewers (e.g. CodeRabbit) may not have posted comments yet, so comment data is unreliable until all checks complete.

**If statusCheckRollup is empty or null:** Treat CI as passing (some PRs have no required checks configured).

**Exit with success** when ALL conditions are met:

- All CI checks have completed (no PENDING, QUEUED, or IN_PROGRESS statuses in statusCheckRollup) and none have failed (or no checks exist)
- No unresolved comments (totalUnresolvedComments == 0)
- No nitpicks (totalNitpicks == 0)

**JSON Structure for Exit Evaluation:**

```json
{
  "totalUnresolvedComments": number,
  "totalNitpicks": number,
  "unresolvedComments": [...],
  "nitpickComments": [...]
}
```

Check `totalUnresolvedComments == 0` and `totalNitpicks == 0` for exit condition.

Report: "PR is clean! All CI checks pass and no unresolved comments."

**Exit with status report** when iteration counter >= max iterations:

- List failing CI checks
- List unresolved comment/nitpick counts
- Suggest running `/iterate-pr` again to continue

### Step 3: Spawn Iteration Subagent

Spawn a Task subagent with `subagent_type: "general-purpose"` using this prompt:

> Handle one iteration of the PR feedback loop:
>
> 1. **Record Starting Commit**: !`git rev-parse HEAD` (save as `startCommit`)
> 2. **Commit and Push**: Invoke `core:commit-push-pr` via the Skill tool
> 3. **Get PR Number**: !`gh pr view --json number --jq '.number'`
> 4. **Wait for CI**: !`rc=0; if command -v gtimeout >/dev/null 2>&1; then gtimeout 600 gh pr checks --watch || rc=$?; elif command -v timeout >/dev/null 2>&1; then timeout 600 gh pr checks --watch || rc=$?; else gh pr checks --watch || rc=$?; fi; case $rc in 0|1|8|124) ;; *) exit $rc;; esac` (10 minute timeout; exit codes: 0=pass, 1=fail, 8=pending, 124=timeout are expected and handled in next step; other codes like 4=auth error are re-raised; uses gtimeout on macOS, timeout on Linux, no timeout as fallback)
> 5. **Check CI Status**: Run `gh pr checks --json name,state,bucket` and parse the output
>    - If any check has `bucket: "fail"`, invoke `core:fix-ci` via the Skill tool. Since you are running autonomously, do NOT wait for user approval — apply the fixes directly. Report what was fixed and exit.
> 6. **Check Comments**: Run `bash "${CLAUDE_PLUGIN_ROOT:-.agents}/skills/unresolved-pr-comments/scripts/unresolvedPrComments.sh"` and parse the JSON output
>    - If unresolved comments or nitpicks exist:
>      1. Group comments by file path and read each file once (not per-comment)
>      2. If a file no longer exists, note the comment may be outdated and skip it
>      3. Assess each comment with an explicit verdict:
>         - **Agree**: Explain why, then fix it
>         - **Disagree**: Explain why the current code is acceptable; do NOT change the code
>         - **Already fixed**: Note that the code already addresses this concern
>      4. After assessing all comments, fix only those you agreed with and exit (next iteration will commit fixes)
> 7. **Report**: Run `git rev-parse HEAD` and compare to `startCommit` to determine if commits were made. Include PR status, CI status, and comments addressed

### Step 4: Loop

After the subagent completes:

1. Increment iteration counter
2. If no commits were made this iteration:
   - Get unresolved comments by running: `bash "${CLAUDE_PLUGIN_ROOT:-.agents}/skills/unresolved-pr-comments/scripts/unresolvedPrComments.sh"`
   - If unresolved comments remain, exit with: "Comments addressed, awaiting reviewer resolution. Run `/iterate-pr` after reviewer responds."
3. Report: "Iteration [N]/[max] complete. Checking state..."
4. Return to Step 2

## Examples

**Successful completion:**

```text
Iteration 1/3: No PR exists
> commit-push-pr -> PR #347 created
> CI failed (lint errors) -> fix-ci -> fixed missing semicolons

Iteration 2/3: CI failures remain
> commit-push-pr -> pushed fixes
> CI passed, 2 review comments
> unresolved-pr-comments -> addressed null check, const usage

Iteration 3/3: Comments pending
> commit-push-pr -> pushed fixes
> CI passed, no unresolved comments

PR is clean! All CI checks pass and no unresolved comments.
```

**Awaiting reviewer resolution:**

```text
Iteration 1/3: PR exists with comments
> commit-push-pr -> pushed comment fixes
> CI passed, 1 comment remains (disagreed with suggestion)

Iteration 2/3: No commits made, comments remain

Comments addressed, awaiting reviewer resolution. Run `/iterate-pr` after reviewer responds.
```

## Input

Maximum iterations: $ARGUMENTS

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/clipboardhealth) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->