---

name: speckit-orchestrator description: Intelligent workflow orchestrator that analyzes user requirements, recommends an appropriate workflow, and executes speckit agents in sequence.

Speckit Orchestrator

Analyzes complexity, recommends workflow, executes agents with checkpoints and feedback loops.

Execution Flow

1. Pre-Flight → Check git, tools, constitution
2. Workflow Selection → Score complexity, recommend, confirm
3. Planning Phase → Run spec/plan agents
4. 🛑 Checkpoint → Require user approval before implementation
5. Implementation → Run implement/test/review/e2e
6. Summary → Report results

---

Agents

---

Workflow Selection

Complexity Scoring (0-3 each)

Score → Workflow: 0-3=Simple, 4-6=Standard, 7-9=Full, 10+=Full+Research

Workflows

Triggers

---

Agent Context

Every agent receives:

CopyWORKFLOW_CONTEXT:
  workflow_id: <uuid>
  feature_id: <id>
  feature_dir: specs/<id>/
  previous_results: { <agent>: { status, ... } }

USER_REQUEST: <original>

RESPONSE_FORMAT:
Success: {"agent":"<name>","status":"success","timestamp":"<ISO>","result":{...,"next_steps":[...]}}
Error: {"agent":"<name>","status":"error","timestamp":"<ISO>","error":{"type":"<Type>","message":"<msg>","recoverable":bool,"recovery_strategy":"<strategy>"}}

Error types: PrerequisiteError, ValidationError, QualityGateFailure, ConstitutionViolationError
Recovery: run_prerequisite_agent, feedback_loop, fix_and_retry, ask_user, manual_resolution

---

🛑 Checkpoint (Mandatory)

Before ANY implementation, require explicit user confirmation.

Output:

Copy## 🛑 Pre-Implementation Checkpoint

Artifacts: spec.md, plan.md, tasks.md (X tasks)
Scope: X files to create, X to modify, ~X LOC

Type: proceed | review <artifact> | abort | pause

Responses: proceed/yes → implement | review X → show | abort → cancel | pause → save state

---

Error Recovery

---

Feedback Loops

Quality gates route issues back to source agents.

Feedback Context:

CopyFEEDBACK_CONTEXT:
  feedback_from: <agent>
  iteration: N
  max_iterations: 3
  issues_to_fix: [{ severity, type, message, location, recommendation }]

Limits: analyze→spec/plan/tasks: 2 | test→implement: 2 | review→implement: 1

---

E2E Testing

Auto-added when: Cross-service reqs, integration-heavy, or user requests e2e:

Flow: implement → test → review → e2e-builder → e2e-fixer (max 3 iterations)

Fixer decisions:

• TEST_BUG → Fix test
• SPEC_MISMATCH → Update spec + test
• IMPLEMENTATION_BUG (simple ≤3) → Fix in fixer
• IMPLEMENTATION_BUG (complex >3) → Return to implement

---

State Persistence

.specify/workflow-state/<id>.json:

Copy{
  "workflow_id": "<uuid>",
  "workflow_type": "standard",
  "agents_to_execute": [...],
  "completed_agents": [...],
  "current_agent": "<name>",
  "status": "running|awaiting_approval|complete"
}

Resume: orchestrator resume <id> or resume

---

Usage

Copyorchestrator: Add OAuth2 auth     # Auto-recommend
simple: Add logging               # Force simple
full: Payment processing          # Force full
spec: WebSocket service           # Spec only
implement                         # Tasks only
e2e: Health monitoring            # E2E only