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 | 6-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 (stdin→stdout) | L3 (full) |
| Codex | exec mode (JSON) | L3 (full) |
| OpenCode | run mode (JSON) | L2 |
| Gemini | -p prompt mode | L1 |
| Hermes | CLI | L1 |
Task Lifecycle (Daemon Side)
- 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 |