How digilogd-cmd/ai-dev-director works
AI DEV DIRECTOR turns a user goal into an ORDER, has AI CLI roles propose and review code, verifies changes in an isolated Git worktree, then exposes passing results for explicit human handling. It also supports milestone missions, autonomous recovery, TRIAD research, and a local console. The graph preserves these distinct product branches and the shared safety, provider, process, and persistence layers. Some subsystem details come from README or source-index references rather than inspected implementation excerpts; those edges are cited accordingly.
Main entry points: orchestrator.py Run Orchestrator · process_runner.py CLI Process Runner · mission.py Mission Planner · director.py CLI Commands
Components 23
User Interfaces
- CLI Commands
director.py - Console Server
companion_server.py - Classic Dashboard
dashboard_server.py - TRINITY Console
console/trinity.js
Build Workflow
- Run Orchestrator
core/orchestrator.py - Mission Planner
core/mission.py - HEAD Roles
agents/claude_head.py - ORDER Schema
schemas/order.py - File Builder
agents/proposal_builder.py - Independent Reviewers
agents/claude_reviewer.py - Git Worktrees
core/git_manager.py - Build Verifier
core/verifier.py - Result Handling
core/result_manager.py
Research Mode
- TRIAD Research
core/research_orchestrator.py - Research Runner
core/research_runner.py
AI Runtime
- Provider Failover
core/provider_manager.py - CLI Process Runner
core/process_runner.py - Usage Ledger
core/usage.py
Safety and State
- Scope Guard
core/safety.py - Autonomy Policy
core/autopilot.py - Run State
core/state_machine.py
Other components
- User
- Subscription AI CLIs
Connections 31
- User → CLI Commands: starts run
- CLI Commands → Run Orchestrator: starts run
director.py - CLI Commands → Mission Planner: starts mission
director.py - User → Console Server: uses console
- TRINITY Console → Console Server: sends requests
- Console Server → Classic Dashboard: serves operations
companion_server.py - Classic Dashboard → Run Orchestrator: starts runs
dashboard_server.py - Classic Dashboard → Mission Planner: controls missions
dashboard_server.py - Mission Planner → Run Orchestrator: runs milestones
- Run Orchestrator → HEAD Roles: requests plan
core/orchestrator.py - HEAD Roles → ORDER Schema: produces ORDER
agents/claude_head.py - Run Orchestrator → File Builder: requests files
core/orchestrator.py - Run Orchestrator → Independent Reviewers: requests review
core/orchestrator.py - Run Orchestrator → Scope Guard: checks scope
core/orchestrator.py - Run Orchestrator → Git Worktrees: creates worktree
core/orchestrator.py - Run Orchestrator → Build Verifier: runs verification
core/orchestrator.py - Run Orchestrator → Autonomy Policy: checks autonomy
core/orchestrator.py - Run Orchestrator → Run State: records run
core/orchestrator.py - User → Result Handling: handles PASS
- Result Handling → Git Worktrees: applies or discards
core/result_manager.py - TRIAD Research → Research Runner: runs research
core/research_orchestrator.py - TRIAD Research → Run Orchestrator: implements experiment
- Run Orchestrator → Provider Failover: selects provider
core/orchestrator.py - Provider Failover → CLI Process Runner: resolves CLI
core/provider_manager.py - HEAD Roles → CLI Process Runner: invokes CLI
agents/claude_head.py - File Builder → CLI Process Runner: invokes CLI
agents/proposal_builder.py - Independent Reviewers → CLI Process Runner: invokes CLI
agents/claude_reviewer.py - CLI Process Runner → Subscription AI CLIs: runs commands
- CLI Process Runner → Usage Ledger: records calls
core/process_runner.py - Mission Planner → Run State: persists progress
core/mission.py - Provider Failover → Run State: stores health
core/provider_manager.py