# soumadip-dev/agenticai-codingassistant architecture

> Architecture diagram of the GitHub repository soumadip-dev/agenticai-codingassistant, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/soumadip-dev/agenticai-codingassistant
- Repository: https://github.com/soumadip-dev/agenticai-codingassistant

## Overview

This is a LangGraph-based coding assistant: it accepts a user request, analyzes and routes it, optionally gathers local project or file context, prepares a task-specific prompt, and returns an AI-generated response. The tool-selection and execution paths are supported by sampled source; the README documents the main workflow, but the graph wiring and AI-assistant implementation were not sampled, so their internal details are limited here.

Main entry points: [`src/nodes/tool_executor.py`](https://github.com/soumadip-dev/agenticai-codingassistant/blob/main/src/nodes/tool_executor.py) (Tool Executor), [`src/nodes/prompt_generator.py`](https://github.com/soumadip-dev/agenticai-codingassistant/blob/main/src/nodes/prompt_generator.py) (Prompt Generator), [`src/graph.py`](https://github.com/soumadip-dev/agenticai-codingassistant/blob/main/src/graph.py) (LangGraph Workflow), [`src/nodes/requirement_analyzer.py`](https://github.com/soumadip-dev/agenticai-codingassistant/blob/main/src/nodes/requirement_analyzer.py) (Requirement Analyzer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Workflow"]
  node_main["CLI Entry<br/>[main.py]"]
  node_graph["LangGraph Workflow<br/>[graph.py]"]
  node_state["Workflow State<br/>[state.py]"]
  node_router["Task Router<br/>[router.py]"]
  node_assistant["AI Assistant<br/>[ai_assistant.py]"]
end

subgraph group_reasoning["Analysis and Prompts"]
  node_analyzer["Requirement Analyzer"]
  node_analyzer_prompt["Analysis Prompt<br/>[analyzer_prompt.py]"]
  node_generator["Prompt Generator"]
  node_generator_prompt["Task Prompts"]
end

subgraph group_tools["Context Tools"]
  node_executor["Tool Executor<br/>[tool_executor.py]"]
  node_registry["Tool Registry<br/>[tool_registry.py]"]
  node_project_tool["Project Context"]
  node_file_tool["File Reader"]
end

subgraph group_models["Model Access"]
  node_llm["LLM Adapter<br/>[llm.py]"]
  node_gemini{{"Google Gemini"}}
end

node_user(("User"))

node_user -->|"enters request"| node_main
node_main -->|"invokes workflow"| node_graph
node_graph -->|"starts analysis"| node_analyzer
node_analyzer -->|"renders prompt"| node_analyzer_prompt
node_analyzer -->|"requests structured analysis"| node_llm
node_llm -->|"invokes model"| node_gemini
node_analyzer -->|"provides analysis"| node_router
node_router -->|"dispatches tool tasks"| node_executor
node_router -->|"dispatches direct tasks"| node_generator
node_executor -->|"looks up tool"| node_registry
node_executor -->|"executes project scan"| node_project_tool
node_executor -->|"executes file read"| node_file_tool
node_executor -->|"supplies tool context"| node_generator
node_generator -->|"selects template"| node_generator_prompt
node_generator -->|"generates prompt"| node_llm
node_generator -->|"provides generated prompt"| node_assistant
node_assistant -->|"requests final response"| node_llm
node_graph -->|"tracks workflow data"| node_state
node_graph -->|"dispatches final stage"| node_assistant
node_main -->|"displays response"| node_user

click node_main "https://github.com/soumadip-dev/agenticai-codingassistant/blob/main/src/main.py"
click node_graph "https://github.com/soumadip-dev/agenticai-codingassistant/blob/main/src/graph.py"
click node_state "https://github.com/soumadip-dev/agenticai-codingassistant/blob/main/src/state.py"
click node_analyzer "https://github.com/soumadip-dev/agenticai-codingassistant/blob/main/src/nodes/requirement_analyzer.py"
click node_analyzer_prompt "https://github.com/soumadip-dev/agenticai-codingassistant/blob/main/src/prompts/analyzer_prompt.py"
click node_router "https://github.com/soumadip-dev/agenticai-codingassistant/blob/main/src/router.py"
click node_executor "https://github.com/soumadip-dev/agenticai-codingassistant/blob/main/src/nodes/tool_executor.py"
click node_registry "https://github.com/soumadip-dev/agenticai-codingassistant/blob/main/src/tools/tool_registry.py"
click node_project_tool "https://github.com/soumadip-dev/agenticai-codingassistant/blob/main/src/tools/project_context_tool.py"
click node_file_tool "https://github.com/soumadip-dev/agenticai-codingassistant/blob/main/src/tools/file_reader_tool.py"
click node_generator "https://github.com/soumadip-dev/agenticai-codingassistant/blob/main/src/nodes/prompt_generator.py"
click node_generator_prompt "https://github.com/soumadip-dev/agenticai-codingassistant/blob/main/src/prompts/generator_prompt.py"
click node_assistant "https://github.com/soumadip-dev/agenticai-codingassistant/blob/main/src/nodes/ai_assistant.py"
click node_llm "https://github.com/soumadip-dev/agenticai-codingassistant/blob/main/src/llm.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_main,node_graph,node_state,node_router,node_assistant,node_user toneBlue
class node_analyzer,node_analyzer_prompt,node_generator,node_generator_prompt toneAmber
class node_executor,node_registry,node_project_tool,node_file_tool toneMint
class node_llm,node_gemini toneRose
```

## Components

### Workflow

- [CLI Entry](https://github.com/soumadip-dev/agenticai-codingassistant/blob/main/src/main.py): `src/main.py`
- [LangGraph Workflow](https://github.com/soumadip-dev/agenticai-codingassistant/blob/main/src/graph.py): `src/graph.py`
- [Workflow State](https://github.com/soumadip-dev/agenticai-codingassistant/blob/main/src/state.py): `src/state.py`
- [Task Router](https://github.com/soumadip-dev/agenticai-codingassistant/blob/main/src/router.py): `src/router.py`
- [AI Assistant](https://github.com/soumadip-dev/agenticai-codingassistant/blob/main/src/nodes/ai_assistant.py): `src/nodes/ai_assistant.py`

### Analysis and Prompts

- [Requirement Analyzer](https://github.com/soumadip-dev/agenticai-codingassistant/blob/main/src/nodes/requirement_analyzer.py): `src/nodes/requirement_analyzer.py`
- [Analysis Prompt](https://github.com/soumadip-dev/agenticai-codingassistant/blob/main/src/prompts/analyzer_prompt.py): `src/prompts/analyzer_prompt.py`
- [Prompt Generator](https://github.com/soumadip-dev/agenticai-codingassistant/blob/main/src/nodes/prompt_generator.py): `src/nodes/prompt_generator.py`
- [Task Prompts](https://github.com/soumadip-dev/agenticai-codingassistant/blob/main/src/prompts/generator_prompt.py): `src/prompts/generator_prompt.py`

### Context Tools

- [Tool Executor](https://github.com/soumadip-dev/agenticai-codingassistant/blob/main/src/nodes/tool_executor.py): `src/nodes/tool_executor.py`
- [Tool Registry](https://github.com/soumadip-dev/agenticai-codingassistant/blob/main/src/tools/tool_registry.py): `src/tools/tool_registry.py`
- [Project Context](https://github.com/soumadip-dev/agenticai-codingassistant/blob/main/src/tools/project_context_tool.py): `src/tools/project_context_tool.py`
- [File Reader](https://github.com/soumadip-dev/agenticai-codingassistant/blob/main/src/tools/file_reader_tool.py): `src/tools/file_reader_tool.py`

### Model Access

- [LLM Adapter](https://github.com/soumadip-dev/agenticai-codingassistant/blob/main/src/llm.py): `src/llm.py`
- **Google Gemini**

### Other components

- **User**

## Connections

- User → CLI Entry: enters request
- CLI Entry → LangGraph Workflow: invokes workflow
- LangGraph Workflow → Requirement Analyzer: starts analysis
- Requirement Analyzer → Analysis Prompt: renders prompt
- Requirement Analyzer → LLM Adapter: requests structured analysis
- LLM Adapter → Google Gemini: invokes model
- Requirement Analyzer → Task Router: provides analysis
- Task Router → Tool Executor: dispatches tool tasks
- Task Router → Prompt Generator: dispatches direct tasks
- Tool Executor → Tool Registry: looks up tool
- Tool Executor → Project Context: executes project scan
- Tool Executor → File Reader: executes file read
- Tool Executor → Prompt Generator: supplies tool context
- Prompt Generator → Task Prompts: selects template
- Prompt Generator → LLM Adapter: generates prompt
- Prompt Generator → AI Assistant: provides generated prompt
- AI Assistant → LLM Adapter: requests final response
- LangGraph Workflow → Workflow State: tracks workflow data
- LangGraph Workflow → AI Assistant: dispatches final stage
- CLI Entry → User: displays response
