Skip to main content

Set Up Parallel AI Agent Orchestration in 5 Minutes

Install, plan your first epic, and dispatch parallel agents.

Prerequisites

  • Claude Code CLI

    The AI coding assistant that powers SPOQ — installed in Step 1 below

  • Claude Account

    A Claude account with an active subscription for Claude Code access

  • Git Repository

    SPOQ operates within Git repositories for version control and change tracking

Installation

Install Claude Code CLI

Download and install the Claude Code command-line interface.

bash
curl -fsSL https://claude.ai/install.sh | bash
Clone the SPOQ Repository

Pull down the repository so you have access to the bootstrap scripts and templates.

bash
git clone https://gitlab.com/kenth56/spoq.git && cd spoq
Bootstrap SPOQ

Initialize your project with SPOQ skills, documentation, and templates. See flag options below.

bash
./scripts/spoq-init.sh --target /path/to/project --standard

Flag Options

FlagDescription
--fullSkills, documentation, and example epic
--standarddefaultSkills and documentation
--minimalSkills only

Your First Epic

SPOQ follows a four-stage pipeline. Here's how it works:

1

Plan

Decompose a high-level goal into atomic tasks with explicit dependencies, effort estimates, and acceptance criteria. SPOQ builds a directed acyclic graph (DAG) for parallel dispatch.

/epic-planning "Add config validation to CLI"
Epic: config-validator
Tasks: 6 atomic units identified
Dependencies: 4 edges in task DAG
Waves: 3 parallel execution waves

Wave 1: [T01] Define schema types, [T02] Create validation utils
Wave 2: [T03] Build CLI parser, [T04] Add error formatters
Wave 3: [T05] Integration tests, [T06] Documentation

Output: spoq/epics/config-validator/epic.yaml
2

Validate

Score the epic against 10 planning quality metrics. Both the average (>=95) and per-metric minimum (>=90) thresholds must pass before execution begins.

/epic-validation @spoq/epics/config-validator
Planning Validation Results
─────────────────────────────
Vision Clarity       98/100
Architecture Qual.   96/100
Task Decomposition   97/100
Dependency Graph     95/100
Coverage Complete.   96/100
Phase Ordering       94/100
Scope Coherence      92/100
Success Criteria     95/100
Risk Identification  97/100
Integration Strat.   93/100
─────────────────────────────
Average: 95.3  Minimum: 92
Result: PASS
3

Execute

Dispatch agent swarms across computed waves. Worker agents (Opus) execute tasks in parallel within each wave, respecting dependency ordering between waves.

/agent-execution @spoq/epics/config-validator
Agent Execution Started
═══════════════════════════════
Wave 1/3 - Dispatching 2 agents
  [T01] Worker-A: Define schema types .... DONE (2m 14s)
  [T02] Worker-B: Create validation utils  DONE (3m 08s)

Wave 2/3 - Dispatching 2 agents
  [T03] Worker-A: Build CLI parser ........ DONE (4m 22s)
  [T04] Worker-B: Add error formatters .... DONE (2m 47s)

Wave 3/3 - Dispatching 2 agents
  [T05] Worker-A: Integration tests ....... DONE (3m 55s)
  [T06] Worker-B: Documentation ........... DONE (1m 33s)

All 6 tasks completed in 3 waves
Total wall-clock time: 11m 09s
Sequential estimate:   ~58m
Speedup: 5.2x
4

Verify

Score delivered code against 10 quality metrics. The average must reach 95 and no individual metric may fall below 80. Failed validations trigger targeted rework.

/agent-validation
Code Validation Results
─────────────────────────────
Syntactic Correct.   98/100
Test Existence       96/100
Test Pass Rate       97/100
Requirements Fidel.  94/100
SOLID Adherence      92/100
Security             96/100
Error Handling       95/100
Scalability          97/100
Code Clarity         96/100
Completeness         98/100
─────────────────────────────
Average: 95.9  Minimum: 92
Result: PASS

All tasks validated. Epic complete.

Ready for Persona-Specialized Teams?

You've seen how /agent-execution dispatches parallel swarms. Agent Teams takes it further with persona-specialized workers, inter-agent messaging, and proactive conflict detection.

Explore Agent Teams

Command Reference

CommandDescriptionExample
/epic-planningDecompose goals into structured epics with atomic tasks, dependency graphs, and parallel execution waves/epic-planning "Implement user authentication system"
/epic-validationScore epic quality against 10 planning metrics with 95 average and 90 per-metric thresholds/epic-validation @spoq/epics/auth-system
/agent-executionExecute tasks with parallel agent swarms across topologically computed waves/agent-execution @spoq/epics/auth-system
/agent-validationScore delivered code against 10 quality metrics with 95 average and 80 per-metric thresholds/agent-validation
/team-executionDeploy persona-specialized agent teams with inter-agent messaging and conflict detection/team-execution @spoq/epics/auth-system
/journal-trackerRecord work sessions with timestamps, confidence scores, and file change provenance for explainability/journal-tracker