How jeff-jayden/auto_dev_agent works
AI Dev Agent turns a user requirement into a reviewed, human-gated GitHub delivery. The principal workflow is repository analysis and retrieval, requirement planning and approval, isolated development with test/repair cycles, independent review, then Draft PR publication and human merge. Jobs and LangGraph support pausing and recovery; SQLite and tracing provide durable state and auditability. README documents broader capabilities than the sampled excerpts, so links for those areas follow its explicit architecture and workflow descriptions; uncertain implementation-level wiring is omitted.
Main entry points: orchestrator.py Task orchestrator · workflow_graph.py Delivery graph · store.py SQLite task store · main.py FastAPI
Components 27
API and execution
- FastAPI
apps/api/main.py - Job worker
src/execution/worker.py - SQLite task store
src/infrastructure/store.py
Delivery workflow
- Task orchestrator
src/workflows/orchestrator.py - Delivery graph
src/workflows/workflow_graph.py - Recovery coordinator
src/workflows/recovery.py - Domain state
src/domain/models.py
Repository intelligence
- Repository analyzer
src/repository/analyzer.py - Repository catalog
src/repository/catalog.py - Code indexer
src/code_intelligence/indexer.py - Retrieval evaluation
src/evaluation/retrieval.py - Golden evaluation
src/evaluation/golden.py
Agents and tools
- Planning agent
src/agents/requirement_planning_agent.py - Exploration agent
src/agents/repository_exploration_agent.py - Development agent
src/agents/code_development_agent.py - Review agent
src/agents/code_review_agent.py - PR description
src/agents/merge_request_builder.py - Developer toolkit
src/tools/developer_toolkit.py - Tool policy
src/tools/policy.py
Delivery and support
- Git worktree
src/sandbox/workspace.py - Model gateway
src/llm/gateway.py - PR publisher
src/scm/publisher.py - UI acceptance
src/ui_validation.py - Tracing
src/observability/tracing.py
Other components
- User
- GitHub
- Figma MCP
Connections 35
- User → FastAPI: submits decisions
- FastAPI → Task orchestrator: requests actions
- FastAPI → Job worker: queues jobs
- FastAPI → SQLite task store: reads projections
- Job worker → Task orchestrator: dispatches jobs
- Job worker → SQLite task store: claims and updates
- Job worker → Recovery coordinator: requests recovery
- Task orchestrator → Delivery graph: runs workflow
- Delivery graph → Planning agent: runs planning
- Delivery graph → Exploration agent: requests context
- Delivery graph → Development agent: runs development
- Delivery graph → Review agent: runs review
- Task orchestrator → Repository analyzer: analyzes repository
- Repository analyzer → Repository catalog: uses repository facts
- Repository analyzer → Code indexer: builds retrieval context
- Planning agent → Model gateway: calls model
- Exploration agent → Developer toolkit: invokes read tools
- Development agent → Developer toolkit: invokes code tools
- Developer toolkit → Tool policy: checks permissions
- Development agent → Git worktree: modifies and tests
- Review agent → Model gateway: calls model
- Review agent → Git worktree: requests restoration
- Delivery graph → SQLite task store: persists checkpoints
- Task orchestrator → SQLite task store: saves task state
- Recovery coordinator → SQLite task store: checks job state
- Task orchestrator → PR description: prepares PR details
- Task orchestrator → PR publisher: requests publication
- PR publisher → GitHub: creates Draft PR
- User → GitHub: merges PR
- Task orchestrator → UI acceptance: runs acceptance
- UI acceptance → Figma MCP: reads design context
- Task orchestrator → Tracing: records execution
- Retrieval evaluation → Code indexer: evaluates retrieval
- Golden evaluation → SQLite task store: records evaluations
- Domain state → SQLite task store: serialized task data