# lokesh701449/agentic-sdlc architecture

> Architecture diagram of the GitHub repository lokesh701449/agentic-sdlc, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/lokesh701449/agentic-sdlc
- Repository: https://github.com/lokesh701449/agentic-sdlc

## Overview

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: [`backend/orchestrator/workflow_orchestrator.py`](https://github.com/lokesh701449/agentic-sdlc/blob/main/backend/orchestrator/workflow_orchestrator.py) (Workflow coordinator), [`backend/main.py`](https://github.com/lokesh701449/agentic-sdlc/blob/main/backend/main.py) (FastAPI endpoints), [`backend/llm/gemini_client.py`](https://github.com/lokesh701449/agentic-sdlc/blob/main/backend/llm/gemini_client.py) (Gemini client), [`backend/agents/coder.py`](https://github.com/lokesh701449/agentic-sdlc/blob/main/backend/agents/coder.py) (Code generator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and UI"]
  node_api["FastAPI endpoints<br/>[main.py]"]
  node_ui["Workflow interface<br/>[page.tsx]"]
  node_history["Workflow history<br/>[page.tsx]"]
  node_monitor_ui["Monitoring view<br/>[page.tsx]"]
  node_file_viewer["Generated file viewer<br/>[FileViewer.tsx]"]
  node_socket_hook["Workflow socket hook"]
end

subgraph group_workflow["Workflow orchestration"]
  node_workflow["Workflow coordinator"]
  node_dependency_order["Dependency ordering"]
  node_runtime_validation["Runtime validation"]
  node_workflow_cli["Workflow runner<br/>[workflow.py]"]
end

subgraph group_agents["SDLC agents"]
  node_planner["Requirement planner<br/>[planner.py]"]
  node_coder["Code generator<br/>[coder.py]"]
  node_tester["Test generator and runner<br/>[tester.py]"]
  node_reviewer["Code reviewer<br/>[reviewer.py]"]
  node_monitor["Workflow monitor<br/>[monitoring.py]"]
  node_generated_files["Generated project files<br/>[coder.py]"]
end

subgraph group_state["Workflow state"]
  node_memory[("Workflow memory<br/>[workflow_memory.py]")]
  node_context["Context manager<br/>[context_manager.py]"]
  node_websocket_manager["WebSocket manager<br/>[manager.py]"]
end

subgraph group_llm["Model integration"]
  node_llm_base["LLM client interface<br/>[base_client.py]"]
  node_gemini["Gemini client<br/>[gemini_client.py]"]
end

node_user(("User"))
node_gemini_api{{"Gemini API"}}

node_user -.->|"submits requirements"| node_ui
node_ui -.->|"uses API"| node_api
node_history -.->|"requests history"| node_api
node_monitor_ui -.->|"requests metrics"| node_api
node_file_viewer -.->|"requests file content"| node_api
node_socket_hook -.->|"streams updates"| node_websocket_manager
node_api -->|"starts workflow"| node_workflow
node_api -->|"reads and updates"| node_memory
node_api -->|"connects clients"| node_websocket_manager
node_workflow_cli -->|"runs workflow"| node_workflow
node_workflow -->|"plans requirements"| node_planner
node_workflow -->|"orders tasks"| node_dependency_order
node_workflow -->|"generates code"| node_coder
node_coder -->|"writes files"| node_generated_files
node_workflow -->|"validates modules"| node_runtime_validation
node_workflow -->|"runs tests"| node_tester
node_workflow -->|"reviews output"| node_reviewer
node_workflow -->|"collects metrics"| node_monitor
node_workflow -->|"persists workflow"| node_memory
node_workflow -->|"emits events"| node_websocket_manager
node_planner -->|"generates plan"| node_gemini
node_coder -->|"generates code"| node_gemini
node_tester -->|"generates tests"| node_gemini
node_reviewer -->|"generates review"| node_gemini
node_gemini -->|"implements interface"| node_llm_base
node_gemini -.->|"calls model service"| node_gemini_api

click node_api "https://github.com/lokesh701449/agentic-sdlc/blob/main/backend/main.py"
click node_ui "https://github.com/lokesh701449/agentic-sdlc/blob/main/frontend/src/app/page.tsx"
click node_history "https://github.com/lokesh701449/agentic-sdlc/blob/main/frontend/src/app/history/page.tsx"
click node_monitor_ui "https://github.com/lokesh701449/agentic-sdlc/blob/main/frontend/src/app/monitoring/page.tsx"
click node_file_viewer "https://github.com/lokesh701449/agentic-sdlc/blob/main/frontend/src/components/FileViewer.tsx"
click node_socket_hook "https://github.com/lokesh701449/agentic-sdlc/blob/main/frontend/src/hooks/useWorkflowSocket.ts"
click node_workflow "https://github.com/lokesh701449/agentic-sdlc/blob/main/backend/orchestrator/workflow_orchestrator.py"
click node_dependency_order "https://github.com/lokesh701449/agentic-sdlc/blob/main/backend/orchestrator/workflow_orchestrator.py"
click node_runtime_validation "https://github.com/lokesh701449/agentic-sdlc/blob/main/backend/orchestrator/workflow_orchestrator.py"
click node_workflow_cli "https://github.com/lokesh701449/agentic-sdlc/blob/main/backend/orchestrator/workflow.py"
click node_planner "https://github.com/lokesh701449/agentic-sdlc/blob/main/backend/agents/planner.py"
click node_coder "https://github.com/lokesh701449/agentic-sdlc/blob/main/backend/agents/coder.py"
click node_tester "https://github.com/lokesh701449/agentic-sdlc/blob/main/backend/agents/tester.py"
click node_reviewer "https://github.com/lokesh701449/agentic-sdlc/blob/main/backend/agents/reviewer.py"
click node_monitor "https://github.com/lokesh701449/agentic-sdlc/blob/main/backend/agents/monitoring.py"
click node_generated_files "https://github.com/lokesh701449/agentic-sdlc/blob/main/backend/agents/coder.py"
click node_memory "https://github.com/lokesh701449/agentic-sdlc/blob/main/backend/memory/workflow_memory.py"
click node_context "https://github.com/lokesh701449/agentic-sdlc/blob/main/backend/memory/context_manager.py"
click node_websocket_manager "https://github.com/lokesh701449/agentic-sdlc/blob/main/backend/websocket/manager.py"
click node_llm_base "https://github.com/lokesh701449/agentic-sdlc/blob/main/backend/llm/base_client.py"
click node_gemini "https://github.com/lokesh701449/agentic-sdlc/blob/main/backend/llm/gemini_client.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_api,node_ui,node_history,node_monitor_ui,node_file_viewer,node_socket_hook,node_user toneBlue
class node_workflow,node_dependency_order,node_runtime_validation,node_workflow_cli toneAmber
class node_planner,node_coder,node_tester,node_reviewer,node_monitor,node_generated_files,node_gemini_api toneMint
class node_memory,node_context,node_websocket_manager toneRose
class node_llm_base,node_gemini toneIndigo
```

## Components

### API and UI

- [FastAPI endpoints](https://github.com/lokesh701449/agentic-sdlc/blob/main/backend/main.py): `backend/main.py`
- [Workflow interface](https://github.com/lokesh701449/agentic-sdlc/blob/main/frontend/src/app/page.tsx): `frontend/src/app/page.tsx`
- [Workflow history](https://github.com/lokesh701449/agentic-sdlc/blob/main/frontend/src/app/history/page.tsx): `frontend/src/app/history/page.tsx`
- [Monitoring view](https://github.com/lokesh701449/agentic-sdlc/blob/main/frontend/src/app/monitoring/page.tsx): `frontend/src/app/monitoring/page.tsx`
- [Generated file viewer](https://github.com/lokesh701449/agentic-sdlc/blob/main/frontend/src/components/FileViewer.tsx): `frontend/src/components/FileViewer.tsx`
- [Workflow socket hook](https://github.com/lokesh701449/agentic-sdlc/blob/main/frontend/src/hooks/useWorkflowSocket.ts): `frontend/src/hooks/useWorkflowSocket.ts`

### Workflow orchestration

- [Workflow coordinator](https://github.com/lokesh701449/agentic-sdlc/blob/main/backend/orchestrator/workflow_orchestrator.py): `backend/orchestrator/workflow_orchestrator.py`
- [Dependency ordering](https://github.com/lokesh701449/agentic-sdlc/blob/main/backend/orchestrator/workflow_orchestrator.py): `backend/orchestrator/workflow_orchestrator.py`
- [Runtime validation](https://github.com/lokesh701449/agentic-sdlc/blob/main/backend/orchestrator/workflow_orchestrator.py): `backend/orchestrator/workflow_orchestrator.py`
- [Workflow runner](https://github.com/lokesh701449/agentic-sdlc/blob/main/backend/orchestrator/workflow.py): `backend/orchestrator/workflow.py`

### SDLC agents

- [Requirement planner](https://github.com/lokesh701449/agentic-sdlc/blob/main/backend/agents/planner.py): `backend/agents/planner.py`
- [Code generator](https://github.com/lokesh701449/agentic-sdlc/blob/main/backend/agents/coder.py): `backend/agents/coder.py`
- [Test generator and runner](https://github.com/lokesh701449/agentic-sdlc/blob/main/backend/agents/tester.py): `backend/agents/tester.py`
- [Code reviewer](https://github.com/lokesh701449/agentic-sdlc/blob/main/backend/agents/reviewer.py): `backend/agents/reviewer.py`
- [Workflow monitor](https://github.com/lokesh701449/agentic-sdlc/blob/main/backend/agents/monitoring.py): `backend/agents/monitoring.py`
- [Generated project files](https://github.com/lokesh701449/agentic-sdlc/blob/main/backend/agents/coder.py): `backend/agents/coder.py`

### Workflow state

- [Workflow memory](https://github.com/lokesh701449/agentic-sdlc/blob/main/backend/memory/workflow_memory.py): `backend/memory/workflow_memory.py`
- [Context manager](https://github.com/lokesh701449/agentic-sdlc/blob/main/backend/memory/context_manager.py): `backend/memory/context_manager.py`
- [WebSocket manager](https://github.com/lokesh701449/agentic-sdlc/blob/main/backend/websocket/manager.py): `backend/websocket/manager.py`

### Model integration

- [LLM client interface](https://github.com/lokesh701449/agentic-sdlc/blob/main/backend/llm/base_client.py): `backend/llm/base_client.py`
- [Gemini client](https://github.com/lokesh701449/agentic-sdlc/blob/main/backend/llm/gemini_client.py): `backend/llm/gemini_client.py`

### Other components

- **User**
- **Gemini API**

## Connections

- 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 (evidence: `backend/main.py`)
- FastAPI endpoints → Workflow memory: reads and updates (evidence: `backend/main.py`)
- FastAPI endpoints → WebSocket manager: connects clients (evidence: `backend/main.py`)
- Workflow runner → Workflow coordinator: runs workflow (evidence: `backend/orchestrator/workflow.py`)
- Workflow coordinator → Requirement planner: plans requirements (evidence: `backend/orchestrator/workflow_orchestrator.py`)
- Workflow coordinator → Dependency ordering: orders tasks (evidence: `backend/orchestrator/workflow_orchestrator.py`)
- Workflow coordinator → Code generator: generates code (evidence: `backend/orchestrator/workflow_orchestrator.py`)
- Code generator → Generated project files: writes files (evidence: `backend/agents/coder.py`)
- Workflow coordinator → Runtime validation: validates modules (evidence: `backend/orchestrator/workflow_orchestrator.py`)
- Workflow coordinator → Test generator and runner: runs tests (evidence: `backend/orchestrator/workflow_orchestrator.py`)
- Workflow coordinator → Code reviewer: reviews output (evidence: `backend/orchestrator/workflow_orchestrator.py`)
- Workflow coordinator → Workflow monitor: collects metrics (evidence: `backend/orchestrator/workflow_orchestrator.py`)
- Workflow coordinator → Workflow memory: persists workflow (evidence: `backend/orchestrator/workflow_orchestrator.py`)
- Workflow coordinator → WebSocket manager: emits events (evidence: `backend/orchestrator/workflow_orchestrator.py`)
- Requirement planner → Gemini client: generates plan (evidence: `backend/agents/planner.py`)
- Code generator → Gemini client: generates code (evidence: `backend/agents/coder.py`)
- Test generator and runner → Gemini client: generates tests (evidence: `backend/agents/tester.py`)
- Code reviewer → Gemini client: generates review (evidence: `backend/agents/reviewer.py`)
- Gemini client → LLM client interface: implements interface (evidence: `backend/llm/gemini_client.py`)
- Gemini client → Gemini API: calls model service (evidence: `README.md`)
