# akilm1998/clinical-coding-ai architecture

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

- Interactive diagram: https://gitdiagram.com/akilm1998/clinical-coding-ai
- Repository: https://github.com/akilm1998/clinical-coding-ai

## Overview

The README describes V3 as a longitudinal, evidence-based coding workflow: clinical context, ICD-10-CM retrieval and coding rules inform LLM-based coding decisions. It also identifies V1 synthetic-note generation and V2 data scraping as earlier versions, and V4 visualization as planned. The supplied tree contains no source files, so nodes are documented capabilities with null implementation paths; edges reflect README statements only.

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clinical_context["Clinical context"]
  node_longitudinal_records["Longitudinal records"]
  node_clinical_context_extraction["Clinical context"]
end

subgraph group_coding["Coding workflow"]
  node_icd_retrieval["ICD-10 retrieval"]
  node_coding_rules["Coding rules"]
  node_llm_decisions["LLM decisions"]
end

subgraph group_visualization["Planned visualization"]
  node_coding_visualization["Coding visualization"]
end

node_longitudinal_records -->|"extracts context"| node_clinical_context_extraction
node_clinical_context_extraction -->|"informs decisions"| node_llm_decisions
node_icd_retrieval -->|"informs decisions"| node_llm_decisions
node_coding_rules -->|"guides decisions"| node_llm_decisions
node_longitudinal_records -.->|"explores records"| node_coding_visualization
node_llm_decisions -.->|"inspects decisions"| node_coding_visualization

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_longitudinal_records,node_clinical_context_extraction toneBlue
class node_icd_retrieval,node_coding_rules,node_llm_decisions toneAmber
class node_coding_visualization toneMint
```

## Components

### Clinical context

- **Longitudinal records**
- **Clinical context**

### Coding workflow

- **ICD-10 retrieval**
- **Coding rules**
- **LLM decisions**

### Planned visualization

- **Coding visualization**

## Connections

- Longitudinal records → Clinical context: extracts context (evidence: `README.md`)
- Clinical context → LLM decisions: informs decisions (evidence: `README.md`)
- ICD-10 retrieval → LLM decisions: informs decisions (evidence: `README.md`)
- Coding rules → LLM decisions: guides decisions (evidence: `README.md`)
- Longitudinal records → Coding visualization: explores records (evidence: `README.md`)
- LLM decisions → Coding visualization: inspects decisions (evidence: `README.md`)
