ada run
Main command. Launches a development task — classification, routing, orchestration, feedback loop.
Synopsis
ada run [options] "<task description>"Flags
| Flag | Description |
|---|---|
--solo | Force solo mode (1 agent only), ignores classification. |
--pipeline <name> | Force a specific pipeline instead of auto-classification. |
--tier <1|2|3> | Force model tier for all agents in the run. |
--dry-run | Print the plan (phases, agents, tiers) without executing. |
--no-bank | Disable insight injection from the ReasoningBank. |
--json | Structured JSON output for CI/CD integration. |
Default is solo
ADA defaults to single-agent mode. Multi-agent fan-out only triggers when classify returns mode=pipeline.
Examples
# Standard run
ada run "implement RBAC permissions system"
# Dry run to validate the plan
ada run --dry-run "refactor auth module"
# → Plan: pipeline=backend-nestjs, phases=3, max-tier=3
# Forced solo for a quick fix
ada run --solo "fix timezone bug in scheduler"
# JSON output for CI
ada run --json "add integration tests" | jq '.phases'