SPOQ

Specialist Orchestrated Queuing for multi-agent AI development.

SPOQ coordinates AI coding agents through wave-based parallel execution with structured quality gates. It provides an MCP server with 29 tools, a CLI for project scaffolding, and template generators for epics and maps.

Install

pip install spoq

Quick Start

1. Initialize a project

spoq init --target /path/to/project --with-mcp

This creates the SPOQ directory structure, installs the selected agent integration, and configures MCP when requested.

2. Use with your coding agent

Claude and Qwen use slash commands. Codex uses skills from .agents/skills, so invoke them with $skill-name or from /skills.

/epic-planning          Plan an epic with atomic tasks and dependency DAG
/epic-validation        Score epic quality (10 metrics, 95/90 threshold)
/agent-execution        Execute tasks with parallel agent swarms
/workflow-execute       Compiled dynamic-workflow dispatch (Claude Code only)
/agent-validation       Score delivered code (10 metrics, 95/80 threshold)
/team-execution         Persona-specialized agent teams
/epic-planning --map    Coordinate multiple epics as a program

Codex equivalents:

$epic-planning
$epic-validation
$agent-execution
$agent-validation

3. Run the MCP server directly

spoq mcp

Or configure in .mcp.json:

{
  "mcpServers": {
    "spoq": {
      "command": "spoq",
      "args": ["mcp"]
    }
  }
}

CLI Commands

MCP Tools (29)

Epic Management: spoq_parse_epic, spoq_validate_epic, spoq_compute_waves, spoq_get_wave_tasks, spoq_analyze_dag, spoq_estimate_effort, spoq_generate_execution_plan, spoq_complete_epic, spoq_generate_skeleton — spoq_complete_epic auto-updates ROADMAP.yml

Map Management: spoq_parse_map, spoq_validate_map, spoq_compute_epic_waves, spoq_analyze_map_dag, spoq_estimate_map_effort, spoq_get_map_status, spoq_list_maps, spoq_generate_map_skeleton

Task Management: spoq_get_task, spoq_update_task_status, spoq_list_task_statuses

Team Execution: spoq_assign_personas, spoq_detect_conflicts

Lifecycle: spoq_list_epics, spoq_promote, spoq_demote

Roadmap: spoq_roadmap_show, spoq_roadmap_sync

Utilities: spoq_get_timestamp, spoq_ping

Links

• Website
• Quickstart Guide
• Methodology
• Source Code

License

MIT