agent-swarm

Orchestrates parallel multi-agent waves with iterative external-model review loops for complex builds.

2|Updated Apr 15, 2026
One-click install
npx skills add https://github.com/tommylower/cortex --skill agent-swarm-tommylower
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agent-swarm
Source: https://github.com/tommylower/cortex/tree/main/agent-workflows/agent-swarm
Command: npx skills add https://github.com/tommylower/cortex --skill agent-swarm-tommylower

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires repomix, llm.

What problem does it solve? Complex multi-feature projects are slow and error-prone when handled by a single agent, and single-model code review has blind spots that let real bugs ship. This Skill provides a structured workflow for decomposing work into parallel agent waves and enforcing rigorous multi-round review before merging. ## Core Features & Use Cases - Wave Execution: Decompose features into independent sub-tasks and run 2-4 agents per wave with worktree isolation, committing after each milestone. - Iterative Review Loop (Ralph Loop): Submit code to an external LLM with rotating review lenses (security, UX, correctness, equivalence, performance) until consecutive approvals are reached. - Adversarial Dual-Review (Santa Method): Require two independent reviewers, ideally different models, to both approve before merging code that ships without human review. - Use Case: When building an auth module, spawn three parallel agents for the implementation, then run security and correctness review rounds via repomix piped to GPT or Gemini until two consecutive approvals gate the merge. ## Quick Start Ask the agent to decompose the current feature into independent sub-tasks and run them as a parallel agent swarm with an adversarial review loop after each wave.

Frequently Asked Questions about agent-swarm

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

FAQPage Schema
How do I run multiple AI agents in parallel on one project?▼

Decompose the feature into independent sub-tasks, then spawn 2-4 agents per wave using the Agent tool with worktree isolation for code-writing agents. Cap parallelism at four agents per wave to prevent merge conflicts, and commit after each logical milestone.

What is an adversarial code review loop with LLMs?▼

An adversarial review loop pipes your flattened codebase to an external LLM with a specific attack lens, such as security or correctness, then iterates on findings until consecutive approvals. Rotating perspectives each round catches different bug classes that a single pass misses.

How do I review code with an external model like GPT or Gemini?▼

Flatten the relevant source with repomix, then pipe the output through the llm CLI to a model like gpt-5.2 or gemini-2.5-pro with a review-focused system prompt. Save each round's findings to a reviews directory and re-run after fixes.

Does the agent swarm workflow require the Codex plugin?▼

No, the Codex plugin is an optional quick path for adversarial review and dual-review gating. A manual fallback using repomix plus the llm CLI works universally with any supported external model provider.

When should I not use a multi-agent swarm workflow?▼

Avoid swarms for small tasks taking under a few hours, since wave coordination and review loops add overhead. The pattern is designed for multi-feature builds with independent components where quality and security are critical.