Components
Detailed breakdown of each system component.
API Server
The API Server is the central hub that manages all data and orchestrates the development pipeline.
Key Services
| Service | Responsibility |
|---|---|
PollingOrchestrator | Task scheduling, dispatch, reconciliation |
AgentGateway | Agent protocol abstraction and routing |
WorkflowPolicyManager | WORKFLOW.md lifecycle management |
BuildTestRunner | Build/lint/test execution (local or Docker) |
GateScoreCalculator | 7-dimension quality scoring |
GitManager | Branch, commit, PR management |
RuntimeRegistry | Daemon registration and selection |
PlanGenerator | AI-powered plan creation |
EventBus | Redis Streams event publishing |
API Routes
| Prefix | Resource |
|---|---|
/api/v1/auth | Authentication (login, register) |
/api/v1/workspaces | Workspace CRUD + members |
/api/v1/projects | Project CRUD |
/api/v1/requirements | Requirement CRUD + AI analysis |
/api/v1/plans | Plan generation + approval |
/api/v1/executions | Execution lifecycle |
/api/v1/gates | Quality gate review |
/api/v1/runtimes | Daemon registration + task dispatch |
/api/v1/budget | Budget queries |
/api/v1/workflows | Workflow policy management |
Runtime Daemon
The daemon is a standalone Python process that runs on developer machines.
Subcomponents
| Component | Role |
|---|---|
AgentDiscovery | Scans PATH for AI agent CLIs |
WorkspaceManager | Creates git worktrees per task |
ProcessManager | Manages agent subprocess lifecycle |
HeartbeatService | Periodic health reporting |
TaskPoller | Polls server for assigned tasks |
ProgressReporter | Reports progress and completion |
Agent Support
| Agent | Invoke Mode | Compatibility |
|---|---|---|
| Claude Code | print mode / app server | L3 (full) |
| Codex | App server | L3 (full) |
| GitHub Copilot | CLI JSON stream | L3 (full) |
| Gemini CLI | CLI | L1 |
| OpenCode | CLI | L2 |
| Kimi Code | CLI | L2 |
| MiMo Code | run --format json | L2 (explicit selection only) |
| Qwen Code | stream-json | L2 (explicit selection only) |
| CodeBuddy | stream-json | L2 (explicit selection only) |
| Qoder CLI | stream-json | L2 (explicit selection only) |
| TraeCode CLI | exec --json | L2 (explicit selection only; real-account live gate pending) |
| ZCode | app-server bidirectional NDJSON protocol | L2 experimental (explicit selection only; approved build and live gate pending) |
| DeepSeek Harness | --profile headless --patch <overlay> --json, prompt on stdin | L2 developer preview (explicit personal Runtime; exact 0.2.0-rc.2 + build acceptance) |
There are thirteen integrations. Claude Code, Codex, GitHub Copilot, Gemini CLI, OpenCode, and Kimi Code are the six standard automatic-routing candidates. MiMo Code, Qwen Code, CodeBuddy, Qoder CLI, TraeCode CLI, ZCode, and DeepSeek Harness are explicit-only; automatic routing/default fallback exclude all seven. TraeCode CLI/ZCode retain their gates, and Harness requires the fixed-build personal-Runtime acceptance below.
Task Lifecycle (Daemon Side)
DeepSeek Harness (deepseek) is the seventh explicit integration. Its shared strict runner uses a managed home, external read-only auth reference, workspace-write/never preset, outer write sandbox, configuration-bound native resume and cancellation-intent supervision. Committed JSONL is not token streaming. It is excluded from shared pools and automatic/default fallback routing; image/fork/read-only review/parallel capabilities remain off. See Harness installation.
- Poll server for assigned tasks
- Prepare workspace (clone/worktree)
- Execute agent with rich prompt
- Collect git diff stats
- Auto-commit and push changes
- Report completion with metrics
Frontend
React 19 single-page application with Ant Design.
Pages
| Page | Purpose |
|---|---|
| Projects | Project management |
| Requirements | Requirement CRUD + AI analysis |
| Board | 5-column Kanban board |
| Executions | Pipeline visualization |
| Gates | Quality gate review |
| Workflow | WORKFLOW.md editor |
| Budget | Usage tracking |
| Runtimes | Daemon monitoring |
| Settings | Configuration |