# skraj1326/verifix architecture

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

- Interactive diagram: https://gitdiagram.com/skraj1326/verifix
- Repository: https://github.com/skraj1326/verifix

## Overview

VerifiX AI is a semiconductor-design verification platform. Its principal workflow takes RTL and specifications through design understanding, planning, assertion and test generation, simulation, coverage analysis, and iterative gap closure; engineers inspect results through the web UI. The graph includes documented failure, regression, waveform, AI-agent, and traceability capabilities. Some subsystems are represented by their exact source directories because their implementation was not sampled; edges without direct source evidence rely on README descriptions or are omitted.

Main entry points: [`backend/app/api/v1`](https://github.com/skraj1326/verifix/tree/main/backend/app/api/v1) (REST API), [`backend/app/services/verification_service.py`](https://github.com/skraj1326/verifix/blob/main/backend/app/services/verification_service.py) (Workflow Coordinator), [`backend/app/engines/rtl_parser/parser.py`](https://github.com/skraj1326/verifix/blob/main/backend/app/engines/rtl_parser/parser.py) (RTL Parser), [`backend/app/engines/test_generator/generator.py`](https://github.com/skraj1326/verifix/blob/main/backend/app/engines/test_generator/generator.py) (Test Generator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["User Interface"]
  node_frontend["Verification Workspace<br/>[page.tsx]"]
  node_api_client["API Client<br/>[api.ts]"]
end

subgraph group_api["API and Coordination"]
  node_api_routes["REST API"]
  node_app["Application Router<br/>[main.py]"]
  node_service["Workflow Coordinator"]
end

subgraph group_design["Design Understanding"]
  node_rtl["RTL Parser<br/>[parser.py]"]
  node_knowledge["Design Knowledge Graph<br/>[builder.py]"]
  node_spec["Specification Parser<br/>[parser.py]"]
end

subgraph group_verification["Verification Engines"]
  node_planner["Verification Planner<br/>[planner.py]"]
  node_assertions["Assertion Generator<br/>[generator.py]"]
  node_tests["Test Generator<br/>[generator.py]"]
  node_simulation["Simulation Orchestrator<br/>[orchestrator.py]"]
  node_coverage["Coverage Analyzer<br/>[analyzer.py]"]
  node_logs["Log Analyzer<br/>[analyzer.py]"]
  node_rootcause["Root Cause Analysis<br/>[engine.py]"]
  node_waveform["Waveform Analysis<br/>[analyzer.py]"]
  node_regression["Regression Intelligence<br/>[engine.py]"]
end

subgraph group_platform["AI and State"]
  node_agents["AI Agents<br/>[agents.py]"]
  node_llm["LLM Client<br/>[llm_client.py]"]
  node_database[("Project Database<br/>[database.py]")]
  node_db_sessions["Database Sessions<br/>[database.py]"]
end

node_engineer(("Verification Engineer"))

node_engineer -->|"uses"| node_frontend
node_frontend -.->|"requests through"| node_api_client
node_api_client -.->|"calls"| node_api_routes
node_app -->|"registers routes"| node_api_routes
node_api_routes -->|"parses RTL"| node_rtl
node_api_routes -->|"builds graph"| node_knowledge
node_api_routes -->|"analyzes coverage"| node_coverage
node_api_routes -->|"generates targeted tests"| node_tests
node_api_routes -->|"runs simulation"| node_simulation
node_api_routes -->|"analyzes logs"| node_logs
node_api_routes -->|"analyzes failures"| node_rootcause
node_api_routes -->|"analyzes regression"| node_regression
node_api_routes -->|"analyzes waveform"| node_waveform
node_api_routes -->|"invokes agents"| node_agents
node_api_routes -->|"uses LLM client"| node_llm
node_service -->|"parses design"| node_rtl
node_service -->|"builds graph"| node_knowledge
node_service -->|"generates plan"| node_planner
node_service -->|"generates assertions"| node_assertions
node_service -->|"generates tests"| node_tests
node_service -->|"measures coverage"| node_coverage
node_service -->|"analyzes logs"| node_logs
node_service -->|"diagnoses failures"| node_rootcause
node_service -->|"analyzes regression"| node_regression
node_service -->|"analyzes waveforms"| node_waveform
node_rtl -->|"provides parsed design"| node_knowledge
node_rtl -->|"provides parsed design"| node_planner
node_rtl -->|"provides parsed design"| node_assertions
node_rtl -->|"provides parsed design"| node_tests
node_engineer -.->|"submits specifications"| node_api_routes
node_spec -.->|"informs planning"| node_planner
node_planner -.->|"guides generation"| node_assertions
node_assertions -.->|"verified in simulation"| node_simulation
node_tests -.->|"executed by"| node_simulation
node_simulation -.->|"produces results for"| node_coverage
node_coverage -.->|"targets gaps with"| node_tests
node_app -->|"initializes database"| node_db_sessions
node_db_sessions -->|"creates tables from"| node_database
node_agents -.->|"uses model access"| node_llm

click node_frontend "https://github.com/skraj1326/verifix/blob/main/frontend/app/rtl/page.tsx"
click node_api_client "https://github.com/skraj1326/verifix/blob/main/frontend/lib/api.ts"
click node_api_routes "https://github.com/skraj1326/verifix/tree/main/backend/app/api/v1"
click node_app "https://github.com/skraj1326/verifix/blob/main/backend/app/main.py"
click node_service "https://github.com/skraj1326/verifix/blob/main/backend/app/services/verification_service.py"
click node_rtl "https://github.com/skraj1326/verifix/blob/main/backend/app/engines/rtl_parser/parser.py"
click node_knowledge "https://github.com/skraj1326/verifix/blob/main/backend/app/engines/knowledge_graph/builder.py"
click node_spec "https://github.com/skraj1326/verifix/blob/main/backend/app/engines/spec_parser/parser.py"
click node_planner "https://github.com/skraj1326/verifix/blob/main/backend/app/engines/verification_planner/planner.py"
click node_assertions "https://github.com/skraj1326/verifix/blob/main/backend/app/engines/assertion_generator/generator.py"
click node_tests "https://github.com/skraj1326/verifix/blob/main/backend/app/engines/test_generator/generator.py"
click node_simulation "https://github.com/skraj1326/verifix/blob/main/backend/app/engines/simulation/orchestrator.py"
click node_coverage "https://github.com/skraj1326/verifix/blob/main/backend/app/engines/coverage_engine/analyzer.py"
click node_logs "https://github.com/skraj1326/verifix/blob/main/backend/app/engines/log_analyzer/analyzer.py"
click node_rootcause "https://github.com/skraj1326/verifix/blob/main/backend/app/engines/root_cause_engine/engine.py"
click node_waveform "https://github.com/skraj1326/verifix/blob/main/backend/app/engines/waveform_analyzer/analyzer.py"
click node_regression "https://github.com/skraj1326/verifix/blob/main/backend/app/engines/regression_engine/engine.py"
click node_agents "https://github.com/skraj1326/verifix/blob/main/backend/app/ai/agents/agents.py"
click node_llm "https://github.com/skraj1326/verifix/blob/main/backend/app/ai/llm_client.py"
click node_database "https://github.com/skraj1326/verifix/blob/main/backend/app/models/database.py"
click node_db_sessions "https://github.com/skraj1326/verifix/blob/main/backend/app/core/database.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_frontend,node_api_client toneBlue
class node_api_routes,node_app,node_service toneAmber
class node_rtl,node_knowledge,node_spec toneMint
class node_planner,node_assertions,node_tests,node_simulation,node_coverage,node_logs,node_rootcause,node_waveform,node_regression toneRose
class node_agents,node_llm,node_database,node_db_sessions,node_engineer toneIndigo
```

## Components

### User Interface

- [Verification Workspace](https://github.com/skraj1326/verifix/blob/main/frontend/app/rtl/page.tsx): `frontend/app/rtl/page.tsx`
- [API Client](https://github.com/skraj1326/verifix/blob/main/frontend/lib/api.ts): `frontend/lib/api.ts`

### API and Coordination

- [REST API](https://github.com/skraj1326/verifix/tree/main/backend/app/api/v1): `backend/app/api/v1`
- [Application Router](https://github.com/skraj1326/verifix/blob/main/backend/app/main.py): `backend/app/main.py`
- [Workflow Coordinator](https://github.com/skraj1326/verifix/blob/main/backend/app/services/verification_service.py): `backend/app/services/verification_service.py`

### Design Understanding

- [RTL Parser](https://github.com/skraj1326/verifix/blob/main/backend/app/engines/rtl_parser/parser.py): `backend/app/engines/rtl_parser/parser.py`
- [Design Knowledge Graph](https://github.com/skraj1326/verifix/blob/main/backend/app/engines/knowledge_graph/builder.py): `backend/app/engines/knowledge_graph/builder.py`
- [Specification Parser](https://github.com/skraj1326/verifix/blob/main/backend/app/engines/spec_parser/parser.py): `backend/app/engines/spec_parser/parser.py`

### Verification Engines

- [Verification Planner](https://github.com/skraj1326/verifix/blob/main/backend/app/engines/verification_planner/planner.py): `backend/app/engines/verification_planner/planner.py`
- [Assertion Generator](https://github.com/skraj1326/verifix/blob/main/backend/app/engines/assertion_generator/generator.py): `backend/app/engines/assertion_generator/generator.py`
- [Test Generator](https://github.com/skraj1326/verifix/blob/main/backend/app/engines/test_generator/generator.py): `backend/app/engines/test_generator/generator.py`
- [Simulation Orchestrator](https://github.com/skraj1326/verifix/blob/main/backend/app/engines/simulation/orchestrator.py): `backend/app/engines/simulation/orchestrator.py`
- [Coverage Analyzer](https://github.com/skraj1326/verifix/blob/main/backend/app/engines/coverage_engine/analyzer.py): `backend/app/engines/coverage_engine/analyzer.py`
- [Log Analyzer](https://github.com/skraj1326/verifix/blob/main/backend/app/engines/log_analyzer/analyzer.py): `backend/app/engines/log_analyzer/analyzer.py`
- [Root Cause Analysis](https://github.com/skraj1326/verifix/blob/main/backend/app/engines/root_cause_engine/engine.py): `backend/app/engines/root_cause_engine/engine.py`
- [Waveform Analysis](https://github.com/skraj1326/verifix/blob/main/backend/app/engines/waveform_analyzer/analyzer.py): `backend/app/engines/waveform_analyzer/analyzer.py`
- [Regression Intelligence](https://github.com/skraj1326/verifix/blob/main/backend/app/engines/regression_engine/engine.py): `backend/app/engines/regression_engine/engine.py`

### AI and State

- [AI Agents](https://github.com/skraj1326/verifix/blob/main/backend/app/ai/agents/agents.py): `backend/app/ai/agents/agents.py`
- [LLM Client](https://github.com/skraj1326/verifix/blob/main/backend/app/ai/llm_client.py): `backend/app/ai/llm_client.py`
- [Project Database](https://github.com/skraj1326/verifix/blob/main/backend/app/models/database.py): `backend/app/models/database.py`
- [Database Sessions](https://github.com/skraj1326/verifix/blob/main/backend/app/core/database.py): `backend/app/core/database.py`

### Other components

- **Verification Engineer**

## Connections

- Verification Engineer → Verification Workspace: uses (evidence: `README.md`)
- Verification Workspace → API Client: requests through
- API Client → REST API: calls
- Application Router → REST API: registers routes (evidence: `backend/app/main.py`)
- REST API → RTL Parser: parses RTL (evidence: `backend/app/api/v1/rtl_analysis.py`)
- REST API → Design Knowledge Graph: builds graph (evidence: `backend/app/api/v1/rtl_analysis.py`)
- REST API → Coverage Analyzer: analyzes coverage (evidence: `backend/app/api/v1/coverage.py`)
- REST API → Test Generator: generates targeted tests (evidence: `backend/app/api/v1/coverage.py`)
- REST API → Simulation Orchestrator: runs simulation (evidence: `backend/app/api/v1/simulation.py`)
- REST API → Log Analyzer: analyzes logs (evidence: `backend/app/api/v1/simulation.py`)
- REST API → Root Cause Analysis: analyzes failures (evidence: `backend/app/api/v1/analysis.py`)
- REST API → Regression Intelligence: analyzes regression (evidence: `backend/app/api/v1/analysis.py`)
- REST API → Waveform Analysis: analyzes waveform (evidence: `backend/app/api/v1/analysis.py`)
- REST API → AI Agents: invokes agents (evidence: `backend/app/api/v1/ai_agents.py`)
- REST API → LLM Client: uses LLM client (evidence: `backend/app/api/v1/ai_agents.py`)
- Workflow Coordinator → RTL Parser: parses design (evidence: `backend/app/services/verification_service.py`)
- Workflow Coordinator → Design Knowledge Graph: builds graph (evidence: `backend/app/services/verification_service.py`)
- Workflow Coordinator → Verification Planner: generates plan (evidence: `backend/app/services/verification_service.py`)
- Workflow Coordinator → Assertion Generator: generates assertions (evidence: `backend/app/services/verification_service.py`)
- Workflow Coordinator → Test Generator: generates tests (evidence: `backend/app/services/verification_service.py`)
- Workflow Coordinator → Coverage Analyzer: measures coverage (evidence: `backend/app/services/verification_service.py`)
- Workflow Coordinator → Log Analyzer: analyzes logs (evidence: `backend/app/services/verification_service.py`)
- Workflow Coordinator → Root Cause Analysis: diagnoses failures (evidence: `backend/app/services/verification_service.py`)
- Workflow Coordinator → Regression Intelligence: analyzes regression (evidence: `backend/app/services/verification_service.py`)
- Workflow Coordinator → Waveform Analysis: analyzes waveforms (evidence: `backend/app/services/verification_service.py`)
- RTL Parser → Design Knowledge Graph: provides parsed design (evidence: `backend/app/engines/knowledge_graph/builder.py`)
- RTL Parser → Verification Planner: provides parsed design (evidence: `backend/app/engines/verification_planner/planner.py`)
- RTL Parser → Assertion Generator: provides parsed design (evidence: `backend/app/engines/assertion_generator/generator.py`)
- RTL Parser → Test Generator: provides parsed design (evidence: `backend/app/engines/test_generator/generator.py`)
- Verification Engineer → REST API: submits specifications (evidence: `README.md`)
- Specification Parser → Verification Planner: informs planning (evidence: `README.md`)
- Verification Planner → Assertion Generator: guides generation (evidence: `README.md`)
- Assertion Generator → Simulation Orchestrator: verified in simulation (evidence: `README.md`)
- Test Generator → Simulation Orchestrator: executed by (evidence: `README.md`)
- Simulation Orchestrator → Coverage Analyzer: produces results for (evidence: `README.md`)
- Coverage Analyzer → Test Generator: targets gaps with (evidence: `README.md`)
- Application Router → Database Sessions: initializes database (evidence: `backend/app/main.py`)
- Database Sessions → Project Database: creates tables from (evidence: `backend/app/core/database.py`)
- AI Agents → LLM Client: uses model access
