# Iterate

> |

- **Type:** Skill
- **Install:** `agentstack add skill-crewforth-crewforth-iterate`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [crewforth](https://agentstack.voostack.com/s/crewforth)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [crewforth](https://github.com/crewforth)
- **Source:** https://github.com/crewforth/crewforth/tree/main/kit/skills/iterate
- **Website:** https://crewforth.com/

## Install

```sh
agentstack add skill-crewforth-crewforth-iterate
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Iterate — refine to Done, don't stop at the first attempt

Trigger phrases: "iterate", "loop until done", "keep going until"

## When
A task has an objective acceptance criterion (tests, a review gate, a spec) and the first attempt may not
meet it. This is a single-session refinement loop — NOT the harness `/loop`, which schedules a prompt on an
interval. Open-ended exploration with no checkable target does not belong here.

## The loop
1. **Name the exit test first** — the concrete, checkable condition that means "done": tests green,
   `crew-review-agent` clean, the spec's acceptance criterion met, zero SonarQube findings. No exit test →
   go to spec-planning first; a loop without a target never terminates.
   **Prefer an external, machine-grounded verifier** — a test exit code, a schema match, a lint/quality gate —
   over an LLM's self-assessment. A model grading its own output inflates; an "it looks done" or even a single
   "review clean" with no objective check is a weak verifier. When the only available check is a judgment call,
   ground it (a second agent with a distinct lens, an explicit rubric) rather than trusting the loop's own say-so.
   For a generative task with no exit code, the `eval-grader` skill *is* that external verifier — a two-layer
   scorecard (code metrics + LLM-judge) over a fixed set, read as signed deltas vs a pinned baseline.
2. **Run one round**: change → verify (drive the real flow, not only tests) → check the exit test.
3. **Report the gap** every round — state what still fails and why. Never loop silently.
4. **Repeat** until the exit test passes. Stop early and surface it if: two rounds pass with no new
   progress (you are stuck — report, don't spin), the exit test itself is wrong, or a blocker needs a
   decision from the user.
5. **Close at the DoD gate, not at a commit.** `crew-commit-agent` still proposes and waits for §4.4
   approval. The loop never commits, pushes, or deploys on its own.

## Guardrails
- **Bounded, not infinite.** A fixed exit test plus a no-progress stop is the whole point; "keep trying
  forever" is a bug, not diligence.
- **Token discipline** ([[token-budget]]): each round re-pays for context. Keep a round's output a summary,
  push heavy logs to `docs/*.md`, and don't fan out a subagent per round unless isolation demands it.
- **Don't move the goalposts.** Never weaken the exit test to end the loop — fix the work, or stop and ask.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [crewforth](https://github.com/crewforth)
- **Source:** [crewforth/crewforth](https://github.com/crewforth/crewforth)
- **License:** MIT
- **Homepage:** https://crewforth.com/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-crewforth-crewforth-iterate
- Seller: https://agentstack.voostack.com/s/crewforth
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.