How lokesh701449/agentic-sdlc works
AgenticSDLC turns a user’s natural-language requirement into a planned, human-approved workflow that generates code, tests and reviews it, validates generated modules, and reports workflow state. The backend orchestrator coordinates the domain stages and persists workflow data; the FastAPI layer exposes workflow operations, while the Next.js frontend provides workflow, history, monitoring, and file-viewing surfaces. The README documents capabilities such as retries, dependency ordering, and caching, but some implementation details and frontend wiring were not excerpted, so those links are omitted or marked unverified.
Main entry points: workflow_orchestrator.py Workflow coordinator · main.py FastAPI endpoints · gemini_client.py Gemini client · coder.py Code generator
Components 23
API and UI
- FastAPI endpoints
backend/main.py - Workflow interface
frontend/src/app/page.tsx - Workflow history
frontend/src/app/history/page.tsx - Monitoring view
frontend/src/app/monitoring/page.tsx - Generated file viewer
frontend/src/components/FileViewer.tsx - Workflow socket hook
frontend/src/hooks/useWorkflowSocket.ts
Workflow orchestration
- Workflow coordinator
backend/orchestrator/workflow_orchestrator.py - Dependency ordering
backend/orchestrator/workflow_orchestrator.py - Runtime validation
backend/orchestrator/workflow_orchestrator.py - Workflow runner
backend/orchestrator/workflow.py
SDLC agents
- Requirement planner
backend/agents/planner.py - Code generator
backend/agents/coder.py - Test generator and runner
backend/agents/tester.py - Code reviewer
backend/agents/reviewer.py - Workflow monitor
backend/agents/monitoring.py - Generated project files
backend/agents/coder.py
Workflow state
- Workflow memory
backend/memory/workflow_memory.py - Context manager
backend/memory/context_manager.py - WebSocket manager
backend/websocket/manager.py
Model integration
- LLM client interface
backend/llm/base_client.py - Gemini client
backend/llm/gemini_client.py
Other components
- User
- Gemini API
Connections 26
- User → Workflow interface: submits requirements
- Workflow interface → FastAPI endpoints: uses API
- Workflow history → FastAPI endpoints: requests history
- Monitoring view → FastAPI endpoints: requests metrics
- Generated file viewer → FastAPI endpoints: requests file content
- Workflow socket hook → WebSocket manager: streams updates
- FastAPI endpoints → Workflow coordinator: starts workflow
backend/main.py - FastAPI endpoints → Workflow memory: reads and updates
backend/main.py - FastAPI endpoints → WebSocket manager: connects clients
backend/main.py - Workflow runner → Workflow coordinator: runs workflow
backend/orchestrator/workflow.py - Workflow coordinator → Requirement planner: plans requirements
backend/orchestrator/workflow_orchestrator.py - Workflow coordinator → Dependency ordering: orders tasks
backend/orchestrator/workflow_orchestrator.py - Workflow coordinator → Code generator: generates code
backend/orchestrator/workflow_orchestrator.py - Code generator → Generated project files: writes files
backend/agents/coder.py - Workflow coordinator → Runtime validation: validates modules
backend/orchestrator/workflow_orchestrator.py - Workflow coordinator → Test generator and runner: runs tests
backend/orchestrator/workflow_orchestrator.py - Workflow coordinator → Code reviewer: reviews output
backend/orchestrator/workflow_orchestrator.py - Workflow coordinator → Workflow monitor: collects metrics
backend/orchestrator/workflow_orchestrator.py - Workflow coordinator → Workflow memory: persists workflow
backend/orchestrator/workflow_orchestrator.py - Workflow coordinator → WebSocket manager: emits events
backend/orchestrator/workflow_orchestrator.py - Requirement planner → Gemini client: generates plan
backend/agents/planner.py - Code generator → Gemini client: generates code
backend/agents/coder.py - Test generator and runner → Gemini client: generates tests
backend/agents/tester.py - Code reviewer → Gemini client: generates review
backend/agents/reviewer.py - Gemini client → LLM client interface: implements interface
backend/llm/gemini_client.py - Gemini client → Gemini API: calls model service
README.md