# dakhane-parag/codesageai-multi-agent_github_code_review_platform architecture

> Architecture diagram of the GitHub repository dakhane-parag/codesageai-multi-agent_github_code_review_platform, 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/dakhane-parag/codesageai-multi-agent_github_code_review_platform
- Repository: https://github.com/dakhane-parag/codesageai-multi-agent_github_code_review_platform

## Overview

CodeSage AI receives GitHub pull-request webhooks, validates and extracts PR diffs, classifies files, runs four parallel Gemini-backed review agents, then aggregates findings into a GitHub review and persists the report for historical REST queries. The graph follows the documented and excerpted webhook workflow; several agent and aggregation internals are represented by their source-indexed modules, without assuming their unsampled implementation details.

Main entry points: [`backend/app/workflows/review_workflow.py`](https://github.com/dakhane-parag/codesageai-multi-agent_github_code_review_platform/blob/main/backend/app/workflows/review_workflow.py) (Review Workflow), [`backend/app/api/routes/webhooks.py`](https://github.com/dakhane-parag/codesageai-multi-agent_github_code_review_platform/blob/main/backend/app/api/routes/webhooks.py) (Webhook Receiver), [`backend/app/services/pr_extraction.py`](https://github.com/dakhane-parag/codesageai-multi-agent_github_code_review_platform/blob/main/backend/app/services/pr_extraction.py) (PR Extractor), [`backend/app/github/service.py`](https://github.com/dakhane-parag/codesageai-multi-agent_github_code_review_platform/blob/main/backend/app/github/service.py) (GitHub Service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ingress["Webhook API"]
  node_api_router["API Router<br/>[main.py]"]
  node_webhook["Webhook Receiver<br/>[webhooks.py]"]
end

subgraph group_extraction["PR Extraction"]
  node_pr_extraction["PR Extractor<br/>[pr_extraction.py]"]
  node_file_classifier["File Classifier<br/>[file_classifier.py]"]
  node_extraction_schema["Extracted PR Data<br/>[extraction.py]"]
end

subgraph group_review["AI Review"]
  node_workflow["Review Workflow<br/>[review_workflow.py]"]
  node_review_state["Workflow State<br/>[review.py]"]
  node_security_agent["Security Agent<br/>[security_agent.py]"]
  node_performance_agent["Performance Agent"]
  node_quality_agent["Quality Agent<br/>[quality_agent.py]"]
  node_testing_agent["Testing Agent<br/>[testing_agent.py]"]
  node_aggregator["Review Aggregator<br/>[aggregator.py]"]
  node_llm_service["Gemini Service<br/>[llm_service.py]"]
end

subgraph group_github["GitHub Integration"]
  node_github_service["GitHub Service<br/>[service.py]"]
  node_github_client["GitHub API Client<br/>[client.py]"]
  node_github_models["GitHub Models<br/>[models.py]"]
end

subgraph group_persistence["Review History"]
  node_reviews_api["Reviews API<br/>[reviews.py]"]
  node_review_repository["Review Repository<br/>[ai_reviews.py]"]
  node_database_session["MongoDB Session<br/>[session.py]"]
  node_review_model["AI Review Model<br/>[ai_review.py]"]
  node_mongodb[("MongoDB")]
end

node_github_actor(("GitHub"))

node_github_actor -->|"sends events"| node_webhook
node_api_router -->|"routes requests"| node_webhook
node_api_router -->|"routes requests"| node_reviews_api
node_webhook -->|"extracts PR"| node_pr_extraction
node_pr_extraction -->|"fetches PR files"| node_github_service
node_pr_extraction -->|"classifies files"| node_file_classifier
node_pr_extraction -->|"returns extracted data"| node_extraction_schema
node_webhook -->|"invokes workflow"| node_workflow
node_webhook -->|"builds state"| node_review_state
node_workflow -->|"uses state"| node_review_state
node_workflow -->|"dispatches analysis"| node_security_agent
node_workflow -->|"dispatches analysis"| node_performance_agent
node_workflow -->|"dispatches analysis"| node_quality_agent
node_workflow -->|"dispatches analysis"| node_testing_agent
node_workflow -->|"dispatches aggregation"| node_aggregator
node_security_agent -->|"obtains LLM"| node_llm_service
node_performance_agent -->|"obtains LLM"| node_llm_service
node_quality_agent -->|"obtains LLM"| node_llm_service
node_testing_agent -->|"obtains LLM"| node_llm_service
node_aggregator -->|"posts review"| node_github_service
node_github_service -->|"sends API calls"| node_github_client
node_github_service -->|"validates responses"| node_github_models
node_webhook -->|"persists review"| node_review_repository
node_review_repository -->|"uses database"| node_database_session
node_review_repository -->|"stores model"| node_review_model
node_database_session -->|"connects to"| node_mongodb
node_reviews_api -->|"queries history"| node_review_repository
node_reviews_api -->|"returns reviews"| node_review_model

click node_api_router "https://github.com/dakhane-parag/codesageai-multi-agent_github_code_review_platform/blob/main/backend/app/api/main.py"
click node_webhook "https://github.com/dakhane-parag/codesageai-multi-agent_github_code_review_platform/blob/main/backend/app/api/routes/webhooks.py"
click node_pr_extraction "https://github.com/dakhane-parag/codesageai-multi-agent_github_code_review_platform/blob/main/backend/app/services/pr_extraction.py"
click node_file_classifier "https://github.com/dakhane-parag/codesageai-multi-agent_github_code_review_platform/blob/main/backend/app/services/file_classifier.py"
click node_extraction_schema "https://github.com/dakhane-parag/codesageai-multi-agent_github_code_review_platform/blob/main/backend/app/schemas/extraction.py"
click node_workflow "https://github.com/dakhane-parag/codesageai-multi-agent_github_code_review_platform/blob/main/backend/app/workflows/review_workflow.py"
click node_review_state "https://github.com/dakhane-parag/codesageai-multi-agent_github_code_review_platform/blob/main/backend/app/schemas/review.py"
click node_security_agent "https://github.com/dakhane-parag/codesageai-multi-agent_github_code_review_platform/blob/main/backend/app/agents/security_agent.py"
click node_performance_agent "https://github.com/dakhane-parag/codesageai-multi-agent_github_code_review_platform/blob/main/backend/app/agents/performance_agent.py"
click node_quality_agent "https://github.com/dakhane-parag/codesageai-multi-agent_github_code_review_platform/blob/main/backend/app/agents/quality_agent.py"
click node_testing_agent "https://github.com/dakhane-parag/codesageai-multi-agent_github_code_review_platform/blob/main/backend/app/agents/testing_agent.py"
click node_aggregator "https://github.com/dakhane-parag/codesageai-multi-agent_github_code_review_platform/blob/main/backend/app/agents/aggregator.py"
click node_llm_service "https://github.com/dakhane-parag/codesageai-multi-agent_github_code_review_platform/blob/main/backend/app/services/llm_service.py"
click node_github_service "https://github.com/dakhane-parag/codesageai-multi-agent_github_code_review_platform/blob/main/backend/app/github/service.py"
click node_github_client "https://github.com/dakhane-parag/codesageai-multi-agent_github_code_review_platform/blob/main/backend/app/github/client.py"
click node_github_models "https://github.com/dakhane-parag/codesageai-multi-agent_github_code_review_platform/blob/main/backend/app/github/models.py"
click node_reviews_api "https://github.com/dakhane-parag/codesageai-multi-agent_github_code_review_platform/blob/main/backend/app/api/routes/reviews.py"
click node_review_repository "https://github.com/dakhane-parag/codesageai-multi-agent_github_code_review_platform/blob/main/backend/app/db/repositories/ai_reviews.py"
click node_database_session "https://github.com/dakhane-parag/codesageai-multi-agent_github_code_review_platform/blob/main/backend/app/db/session.py"
click node_review_model "https://github.com/dakhane-parag/codesageai-multi-agent_github_code_review_platform/blob/main/backend/app/models/ai_review.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_router,node_webhook toneBlue
class node_pr_extraction,node_file_classifier,node_extraction_schema toneAmber
class node_workflow,node_review_state,node_security_agent,node_performance_agent,node_quality_agent,node_testing_agent,node_aggregator,node_llm_service toneMint
class node_github_service,node_github_client,node_github_models toneRose
class node_reviews_api,node_review_repository,node_database_session,node_review_model,node_mongodb,node_github_actor toneIndigo
```

## Components

### Webhook API

- [API Router](https://github.com/dakhane-parag/codesageai-multi-agent_github_code_review_platform/blob/main/backend/app/api/main.py): `backend/app/api/main.py`
- [Webhook Receiver](https://github.com/dakhane-parag/codesageai-multi-agent_github_code_review_platform/blob/main/backend/app/api/routes/webhooks.py): `backend/app/api/routes/webhooks.py`

### PR Extraction

- [PR Extractor](https://github.com/dakhane-parag/codesageai-multi-agent_github_code_review_platform/blob/main/backend/app/services/pr_extraction.py): `backend/app/services/pr_extraction.py`
- [File Classifier](https://github.com/dakhane-parag/codesageai-multi-agent_github_code_review_platform/blob/main/backend/app/services/file_classifier.py): `backend/app/services/file_classifier.py`
- [Extracted PR Data](https://github.com/dakhane-parag/codesageai-multi-agent_github_code_review_platform/blob/main/backend/app/schemas/extraction.py): `backend/app/schemas/extraction.py`

### AI Review

- [Review Workflow](https://github.com/dakhane-parag/codesageai-multi-agent_github_code_review_platform/blob/main/backend/app/workflows/review_workflow.py): `backend/app/workflows/review_workflow.py`
- [Workflow State](https://github.com/dakhane-parag/codesageai-multi-agent_github_code_review_platform/blob/main/backend/app/schemas/review.py): `backend/app/schemas/review.py`
- [Security Agent](https://github.com/dakhane-parag/codesageai-multi-agent_github_code_review_platform/blob/main/backend/app/agents/security_agent.py): `backend/app/agents/security_agent.py`
- [Performance Agent](https://github.com/dakhane-parag/codesageai-multi-agent_github_code_review_platform/blob/main/backend/app/agents/performance_agent.py): `backend/app/agents/performance_agent.py`
- [Quality Agent](https://github.com/dakhane-parag/codesageai-multi-agent_github_code_review_platform/blob/main/backend/app/agents/quality_agent.py): `backend/app/agents/quality_agent.py`
- [Testing Agent](https://github.com/dakhane-parag/codesageai-multi-agent_github_code_review_platform/blob/main/backend/app/agents/testing_agent.py): `backend/app/agents/testing_agent.py`
- [Review Aggregator](https://github.com/dakhane-parag/codesageai-multi-agent_github_code_review_platform/blob/main/backend/app/agents/aggregator.py): `backend/app/agents/aggregator.py`
- [Gemini Service](https://github.com/dakhane-parag/codesageai-multi-agent_github_code_review_platform/blob/main/backend/app/services/llm_service.py): `backend/app/services/llm_service.py`

### GitHub Integration

- [GitHub Service](https://github.com/dakhane-parag/codesageai-multi-agent_github_code_review_platform/blob/main/backend/app/github/service.py): `backend/app/github/service.py`
- [GitHub API Client](https://github.com/dakhane-parag/codesageai-multi-agent_github_code_review_platform/blob/main/backend/app/github/client.py): `backend/app/github/client.py`
- [GitHub Models](https://github.com/dakhane-parag/codesageai-multi-agent_github_code_review_platform/blob/main/backend/app/github/models.py): `backend/app/github/models.py`

### Review History

- [Reviews API](https://github.com/dakhane-parag/codesageai-multi-agent_github_code_review_platform/blob/main/backend/app/api/routes/reviews.py): `backend/app/api/routes/reviews.py`
- [Review Repository](https://github.com/dakhane-parag/codesageai-multi-agent_github_code_review_platform/blob/main/backend/app/db/repositories/ai_reviews.py): `backend/app/db/repositories/ai_reviews.py`
- [MongoDB Session](https://github.com/dakhane-parag/codesageai-multi-agent_github_code_review_platform/blob/main/backend/app/db/session.py): `backend/app/db/session.py`
- [AI Review Model](https://github.com/dakhane-parag/codesageai-multi-agent_github_code_review_platform/blob/main/backend/app/models/ai_review.py): `backend/app/models/ai_review.py`
- **MongoDB**

### Other components

- **GitHub**

## Connections

- GitHub → Webhook Receiver: sends events (evidence: `README.md`)
- API Router → Webhook Receiver: routes requests (evidence: `backend/app/api/main.py`)
- API Router → Reviews API: routes requests (evidence: `backend/app/api/main.py`)
- Webhook Receiver → PR Extractor: extracts PR (evidence: `backend/app/api/routes/webhooks.py`)
- PR Extractor → GitHub Service: fetches PR files (evidence: `backend/app/services/pr_extraction.py`)
- PR Extractor → File Classifier: classifies files (evidence: `backend/app/services/pr_extraction.py`)
- PR Extractor → Extracted PR Data: returns extracted data (evidence: `backend/app/services/pr_extraction.py`)
- Webhook Receiver → Review Workflow: invokes workflow (evidence: `backend/app/api/routes/webhooks.py`)
- Webhook Receiver → Workflow State: builds state (evidence: `backend/app/api/routes/webhooks.py`)
- Review Workflow → Workflow State: uses state (evidence: `backend/app/workflows/review_workflow.py`)
- Review Workflow → Security Agent: dispatches analysis (evidence: `backend/app/workflows/review_workflow.py`)
- Review Workflow → Performance Agent: dispatches analysis (evidence: `backend/app/workflows/review_workflow.py`)
- Review Workflow → Quality Agent: dispatches analysis (evidence: `backend/app/workflows/review_workflow.py`)
- Review Workflow → Testing Agent: dispatches analysis (evidence: `backend/app/workflows/review_workflow.py`)
- Review Workflow → Review Aggregator: dispatches aggregation (evidence: `backend/app/workflows/review_workflow.py`)
- Security Agent → Gemini Service: obtains LLM (evidence: `backend/app/agents/security_agent.py`)
- Performance Agent → Gemini Service: obtains LLM (evidence: `backend/app/agents/performance_agent.py`)
- Quality Agent → Gemini Service: obtains LLM (evidence: `backend/app/agents/quality_agent.py`)
- Testing Agent → Gemini Service: obtains LLM (evidence: `backend/app/agents/testing_agent.py`)
- Review Aggregator → GitHub Service: posts review (evidence: `backend/app/agents/aggregator.py`)
- GitHub Service → GitHub API Client: sends API calls (evidence: `backend/app/github/service.py`)
- GitHub Service → GitHub Models: validates responses (evidence: `backend/app/github/service.py`)
- Webhook Receiver → Review Repository: persists review (evidence: `backend/app/api/routes/webhooks.py`)
- Review Repository → MongoDB Session: uses database (evidence: `backend/app/db/repositories/ai_reviews.py`)
- Review Repository → AI Review Model: stores model (evidence: `backend/app/db/repositories/ai_reviews.py`)
- MongoDB Session → MongoDB: connects to (evidence: `backend/app/db/session.py`)
- Reviews API → Review Repository: queries history (evidence: `backend/app/api/routes/reviews.py`)
- Reviews API → AI Review Model: returns reviews (evidence: `backend/app/api/routes/reviews.py`)
