How ruslanmv/agent-generator works
agent-generator combines deterministic multi-agent project generation with the Matrix Builder contract engine. The primary workflow turns an idea into a plan/spec, renders a framework-specific project, and validates the result. The second major workflow creates a locked blueprint and scoped batches, then validates coder changes and produces repair guidance or versioned commits. The repository also exposes these capabilities through SDK, CLI, HTTP, web, and demo surfaces. Some subsystem links are documented rather than verified from sampled implementation; those use README evidence.
Main entry points: engine.py AgentGenerator engine · control Contract enforcement · project_spec.py Project specification · main.py Wizard service API
Components 26
Project Generation
- Idea planning
src/agent_generator/application/planning_service.py - Project specification
src/agent_generator/domain/project_spec.py - Framework generators
src/agent_generator/frameworks - Generated project
Matrix Builder Engine
- AgentGenerator engine
src/agent_generator/engine.py - Blueprint design
src/agent_generator/blueprints - Blueprint contract
src/agent_generator/contracts/blueprint.py - Batch contract
src/agent_generator/contracts/batch.py - Version contract
src/agent_generator/contracts/versioning.py - Coder changes
- Contract enforcement
src/agent_generator/control - Repair guidance
src/agent_generator/control/repair.py
Validation and Release
- Project validation
src/agent_generator/validators/pipeline.py - Validation results
src/agent_generator/contracts/validation.py - Release bundles
src/agent_generator/artifacts - Signed standards
src/agent_generator/standards
Service Interfaces
- CLI and mb
src/agent_generator/cli.py - Matrix HTTP API
src/agent_generator/http/app.py - Wizard service API
backend/app/main.py - Application database
backend/app/db/session.py - Hosted demo API
hf/space_app/main.py
Builder Experience
- Builder interface
frontend/src/App.tsx - Pipeline editor
frontend/src/pages/Pipeline.tsx - Project pipeline loader
frontend/src/pages/pipeline/usePipeline.ts
Other components
- Idea author
- AI coder
Connections 26
- Idea author → Idea planning: describes idea
- Idea planning → Project specification: builds spec
src/agent_generator/application/planning_service.py - Project specification → Framework generators: renders project
- Framework generators → Generated project: writes files
- Project specification → Project validation: validates spec
src/agent_generator/validators/pipeline.py - Generated project → Project validation: validates files
src/agent_generator/validators/pipeline.py - Idea author → AgentGenerator engine: submits idea
- AgentGenerator engine → Blueprint design: generates candidates
src/agent_generator/engine.py - Blueprint design → Blueprint contract: forms blueprint
- AgentGenerator engine → Batch contract: plans batches
src/agent_generator/engine.py - Blueprint contract → AI coder: bounds work
- AI coder → Coder changes: produces changes
- Coder changes → Contract enforcement: submits patch
- Contract enforcement → Validation results: validates patch
- Contract enforcement → Repair guidance: requests repair
src/agent_generator/control/__init__.py - Contract enforcement → Version contract: records commit
- AgentGenerator engine → Release bundles: exports bundle
src/agent_generator/engine.py - Release bundles → Signed standards: locks standards
- CLI and mb → AgentGenerator engine: invokes engine
- Matrix HTTP API → AgentGenerator engine: calls SDK
src/agent_generator/http/app.py - Wizard service API → Application database: initializes database
backend/app/main.py - Wizard service API → Builder interface: serves wizard APIs
backend/app/main.py - Builder interface → Pipeline editor: opens editor
- Pipeline editor → Project pipeline loader: loads project graph
frontend/src/pages/Pipeline.tsx - Project pipeline loader → Wizard service API: fetches project
frontend/src/pages/pipeline/usePipeline.ts - Hosted demo API → Builder interface: serves demo SPA
hf/space_app/main.py