team-swarm

Orchestrate multi-agent swarm exploration with pheromone-guided selection and deterministic update loops.

76|5|Updated Jul 7, 2026
One-click install
npx skills add https://github.com/catlog22/pi-maestro-flow --skill team-swarm-catlog22
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: team-swarm
Source: https://github.com/catlog22/pi-maestro-flow/tree/main/.pi/skills/team-swarm
Command: npx skills add https://github.com/catlog22/pi-maestro-flow --skill team-swarm-catlog22

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Team-swarm solves the problem of a single coding agent working serially on complex tasks by adding a multi-agent orchestration layer that can plan, parallelize, track progress, and converge on better results with less manual coordination.

Core Features & Use Cases

  • Swarm orchestration: Dispatches multiple ant workers across a task space with pheromone-guided selection, DAG-like coordination, and iterative updates.
  • Deterministic control loop: Uses Python scripts for initialization, selection, pheromone updates, convergence checks, and final reporting.
  • Schema-locked outputs: Forces each ant to write validated JSON artifacts so results can be safely scored and aggregated.
  • Persistent optimization: Maintains pheromone state, trails, best solutions, and convergence history across iterations.
  • Use cases: Codebase exploration, refactor search, test generation, bug hunting, and other structured search problems where parallel exploration is valuable.

Quick Start

Ask the coordinator to turn your task into a swarm run and execute the full multi-agent exploration workflow for the chosen search space.

Frequently Asked Questions about team-swarm

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

FAQPage Schema
How do I use multi-agent orchestration to parallelize codebase exploration?

Multi-agent orchestration parallelizes codebase exploration by dispatching multiple ant workers across the task space with pheromone-guided selection and deterministic update loops. Workers write validated JSON artifacts so results can be safely scored and aggregated.

What is pheromone-guided selection in multi-agent swarm exploration?

Pheromone-guided selection in multi-agent swarm exploration is a mechanism that maintains pheromone state, trails, and best solutions across iterations. It applies ant colony optimization principles to direct agents toward promising areas of the search space.

Can I use a multi-agent swarm for bug hunting and test generation?

Yes, you can use a multi-agent swarm for bug hunting and test generation. The orchestration layer applies to code exploration, refactor search, and other structured search problems where parallel exploration of the task space is valuable.

Do I need JSON schema validation for multi-agent swarm outputs?

Yes, JSON schema validation is required for multi-agent swarm outputs. The orchestration forces each ant worker to write schema-locked JSON artifacts so that results can be safely scored, aggregated, and managed in the session state.

What's the best way to coordinate multiple agents working on a complex refactor search?

The best way to coordinate multiple agents on a complex refactor search is using a deterministic control loop with DAG-like coordination. Python scripts handle initialization, selection, pheromone updates, convergence checks, and final reporting.

Why does my multi-agent swarm exploration fail to converge on a solution?

Multi-agent swarm exploration fails to converge when the deterministic control loop lacks proper pheromone state management or convergence checks. The system requires strict JSON ant artifacts and session state tracking to maintain convergence history across iterations.