iterative-fleet

Orchestrate reviewer-gated iterative refinement for parallel agent workers.

1|Updated Apr 16, 2026
One-click install
npx skills add https://github.com/quickcall-dev/skills --skill iterative-fleet
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: iterative-fleet
Source: https://github.com/quickcall-dev/skills/tree/main/skills/iterative-fleet
Command: npx skills add https://github.com/quickcall-dev/skills --skill iterative-fleet

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

iterative-fleet helps teams run complex, multi-round work with multiple parallel agent workers while enforcing a quality gate so the work only advances when an explicit reviewer verdict approves it.

Core Features & Use Cases

  • Reviewer-gated iteration loop: Workers run in cycles and a dedicated reviewer reads worker logs to write a verdict that determines whether to continue, iterate again, or pause for escalation.
  • DAG ordering per iteration: Uses depends_on to run workers in topological layers for correct sequencing (e.g., researcher → builder → reviewer) across every iteration.
  • Multi-provider worker support: Designed for headless claude -p, codex exec, or pi -p providers, with configurable model settings per fleet/worker.
  • Operator-controlled safety: The orchestrator never auto-kills or auto-restarts workers; it only reads verdicts and worker completion signals, so operators remain in control of intervention.

Quick Start

Launch an iterative reviewer-gated fleet by creating a fleet.json with exactly one type: "reviewer" worker and then running bash ${AGENTS_SKILLS_DIR}/scripts/launch.sh $FLEET_ROOT followed by bash ${AGENTS_SKILLS_DIR}/scripts/status.sh $FLEET_ROOT.

Frequently Asked Questions about iterative-fleet

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I orchestrate parallel agent workers with a reviewer-gated iteration loop?

You orchestrate reviewer-gated parallel agent workers by defining a fleet.json with one reviewer worker, then running launch.sh and status.sh. The orchestrator coordinates execution via DAG layers and applies stop conditions like max_iterations or reviewer_lgtm_count.

How does DAG scheduling work for parallel agent fleets?

DAG scheduling executes parallel agent workers in topological layers using depends_on to sequence tasks correctly across every iteration. This ensures dependencies like researcher, builder, and reviewer run in the proper order before the next layer starts.

Can I use multiple AI providers like claude and codex for parallel worker execution?

Multiple AI providers are supported for parallel worker execution, including headless claude -p, codex exec, and pi -p. You can configure model settings per fleet or per worker to match your specific task requirements.

Does the fleet orchestrator auto-restart or auto-kill stuck agent workers?

The fleet orchestrator never auto-kills or auto-restarts agent workers. It only reads reviewer verdicts and worker completion signals, ensuring operators remain in full control of any manual intervention during iterative refinement.

What stop conditions can I set for iterative agent refinement workflows?

Stop conditions for iterative agent refinement include max_iterations to cap cycles, reviewer_lgtm_count to stop after enough approvals, and an optional cost_cap_usd limit to control spending across parallel workers.

Do I need tmux automation to run iterative fleet orchestration?

Tmux automation is used to manage the parallel worker processes within the iterative fleet orchestration. You need a fleet.json configuration defining your workers and a reviewer to initialize the environment before launching the workflow.