# iterate

Iterate on a GitHub pull request — drive it through CI, code review, and QA
until it is merge-ready. The agent monitors PR state, diagnoses and fixes
problems, retries flaky failures, and keeps looping until the PR is green
or a blocker requires human help.

## Trigger

`/iterate`

## How it works

1. **Snapshot** PR state using `gh` CLI commands (checks, reviews, mergeability).
2. **Evaluate** what to do: fix CI failures, address review feedback, retry
   flaky checks, or wait.
3. **Fix and push** — then loop back to step 1.
4. **Refresh `.pr/` artifacts** — if the PR carries generated artifacts in a
   `.pr/` folder and the agent can tell how they were made, it regenerates any
   that the code changes made stale.
5. **Stop** when the PR is merge-ready, closed, or blocked.

No scripts — the agent is the orchestration loop, using only standard `gh` CLI.

## Requirements

- GitHub CLI (`gh`) — authenticated with repo access
- A GitHub PR (or a branch to create one from)