Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

Parallel Agent Execution

agentful runs multiple agents in parallel by auto-enabling Claude Code's TeammateTool, reducing build time by 3-5x.

How It Works

On first run, agentful automatically:

  1. Detects Claude Code installation
  2. Patches TeammateTool gate function (creates backup)
  3. Enables parallel agent execution

You don't need to do anything - it just works.

// Orchestrator spawns 3 agents simultaneously
Task("backend", "Implement auth API");
Task("frontend", "Create login UI");
Task("tester", "Write tests");
 
// All 3 run at the same time

Example: Building Auth Feature

🚀 Parallel (6 min)

backend API
frontend UI
tester Tests
reviewer
0min5min10min15min

🐌 Sequential (15 min)

backend API
frontend UI
tester Tests
reviewer
0min5min10min15min

Result: Parallel is 2.5x faster (6 min vs 15 min)

Task Independence

Tasks must be independent to run in parallel:

✅ Safe:

Task("backend", "src/api/auth.ts");
Task("frontend", "src/pages/Login.tsx");
// Different files, no conflicts

❌ Unsafe:

Task("backend", "Implement auth API");
Task("frontend", "Use auth API"); // Needs backend first!

Manual Control

Check status:

node lib/parallel-execution.js capabilities

Force enable:

node lib/parallel-execution.js enable

Related