How tejas004s/multi-agent-software-planning-system works
DevForge AI turns a user’s project idea into an engineering plan through sequential requirements, architecture, implementation, QA, and report stages. The frontend collects the prompt and displays the report and execution timeline; the FastAPI endpoint invokes a LangGraph workflow whose state passes through the stages. Agents use Gemini for generation. The README documents all five agent responsibilities; source excerpts show only some implementations, so links through the graph-node layer reflect the documented workflow rather than inspected wrapper code.
Main entry points: nodes.py Workflow nodes · App.jsx Dashboard app · gemini_client.py Gemini client · workflow.py Plan endpoint
Components 19
Frontend
- Prompt form
frontend/src/components/PromptForm.jsx - Dashboard app
frontend/src/App.jsx - API client
frontend/src/services/api.js - Agent timeline
frontend/src/components/AgentTimeline.jsx - Report viewer
frontend/src/components/ReportViewer.jsx
API and orchestration
- Plan endpoint
backend/api/workflow.py - Workflow service
backend/services/workflow_service.py - LangGraph workflow
backend/graph/workflow.py - Workflow nodes
backend/graph/nodes.py - Shared workflow state
backend/schemas/state.py
Planning agents
- Requirements agent
backend/agents/project_manager.py - Architecture agent
backend/agents/architect.py - Implementation agent
backend/agents/implementation_engineer.py - QA reviewer
backend/agents/qa_engineer.py - Report generator
backend/agents/report_generator.py - Base agent
backend/agents/base_agent.py
AI service
- Gemini client
backend/services/gemini_client.py
Other components
- User
- Google Gemini
Connections 21
- User → Prompt form: enters idea
- Prompt form → Dashboard app: submits prompt
- Dashboard app → API client: sends request
- API client → Plan endpoint: POST prompt
- Plan endpoint → Workflow service: runs workflow
- Workflow service → LangGraph workflow: invokes graph
- LangGraph workflow → Workflow nodes: dispatches stages
- LangGraph workflow → Shared workflow state: uses state schema
- Workflow nodes → Requirements agent: runs requirements
- Workflow nodes → Architecture agent: runs architecture
- Workflow nodes → Implementation agent: runs implementation
- Workflow nodes → QA reviewer: runs review
- Workflow nodes → Report generator: generates report
- Requirements agent → Base agent: uses base
- Base agent → Gemini client: generates text
- Implementation agent → Gemini client: generates text
- QA reviewer → Gemini client: generates text
- Gemini client → Google Gemini: requests generation
- Plan endpoint → Dashboard app: returns report and logs
- Dashboard app → Agent timeline: displays logs
- Dashboard app → Report viewer: displays report