# egonex-ai/understand-anything architecture

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

- Interactive diagram: https://gitdiagram.com/egonex-ai/understand-anything
- Repository: https://github.com/egonex-ai/understand-anything
- Video tour (about a minute): https://gitdiagram.com/egonex-ai/understand-anything/video

## Overview

Understand Anything analyzes codebases, knowledge bases, and Figma designs into knowledge graphs, then presents them in an interactive dashboard and provides chat, explanation, onboarding, and change-impact tools. The main workflow is project analysis → graph generation → dashboard exploration. The README documents these product capabilities, but excerpts do not expose the full analysis orchestration or all integrations; those links are shown only where documented.

Main entry points: [`understand-anything-plugin/packages/dashboard/src/App.tsx`](https://github.com/egonex-ai/understand-anything/blob/main/understand-anything-plugin/packages/dashboard/src/App.tsx) (Dashboard App), [`understand-anything-plugin/packages/core/src/analyzer/graph-builder.ts`](https://github.com/egonex-ai/understand-anything/blob/main/understand-anything-plugin/packages/core/src/analyzer/graph-builder.ts) (Graph Generation), [`understand-anything-plugin/skills/understand`](https://github.com/egonex-ai/understand-anything/tree/main/understand-anything-plugin/skills/understand) (Project Analysis), [`understand-anything-plugin/skills/understand/extract-structure.mjs`](https://github.com/egonex-ai/understand-anything/blob/main/understand-anything-plugin/skills/understand/extract-structure.mjs) (Structure Extraction)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_analysis["Analysis and Graphs"]
  node_analysis_pipeline["Project Analysis"]
  node_structure_extraction["Structure Extraction"]
  node_language_plugins["Language Parsers"]
  node_graph_generation["Graph Generation<br/>[graph-builder.ts]"]
  node_persistence[("Graph Persistence")]
  node_incremental["Incremental Updates"]
end

subgraph group_enrichment["Graph Enrichment"]
  node_layer_detection["Layer Detection<br/>[layer-detector.ts]"]
  node_tour_generation["Guided Tours<br/>[tour-generator.ts]"]
  node_language_lessons["Language Concepts<br/>[language-lesson.ts]"]
end

subgraph group_dashboard["Dashboard Exploration"]
  node_dashboard_app["Dashboard App<br/>[App.tsx]"]
  node_dashboard_state["Dashboard State<br/>[store.ts]"]
  node_structural_graph["Structural Graph<br/>[GraphView.tsx]"]
  node_domain_graph["Domain Graph"]
  node_knowledge_graph_view["Knowledge Graph View"]
  node_node_details["Node Details<br/>[NodeInfo.tsx]"]
  node_code_viewer["Code Viewer<br/>[CodeViewer.tsx]"]
  node_search["Graph Search<br/>[search.ts]"]
  node_semantic_search["Semantic Search"]
end

subgraph group_assistants["Developer Assistance"]
  node_diff_analysis["Diff Impact<br/>[diff-analyzer.ts]"]
  node_chat_context["Chat Context<br/>[context-builder.ts]"]
  node_chat["Codebase Chat<br/>[understand-chat.ts]"]
  node_explanations["Code Explanations<br/>[explain-builder.ts]"]
  node_onboarding["Onboarding Guide<br/>[onboard-builder.ts]"]
end

subgraph group_integrations["Knowledge and Design"]
  node_knowledge_import["Knowledge Base Analysis"]
  node_figma_import["Figma Analysis"]
end

node_developer(("Developer"))

node_developer -->|"starts analysis"| node_analysis_pipeline
node_analysis_pipeline -->|"extracts structure"| node_structure_extraction
node_structure_extraction -.->|"parses languages"| node_language_plugins
node_analysis_pipeline -->|"builds graph"| node_graph_generation
node_graph_generation -->|"saves graph"| node_persistence
node_analysis_pipeline -->|"updates changed files"| node_incremental
node_graph_generation -->|"groups layers"| node_layer_detection
node_graph_generation -->|"generates tours"| node_tour_generation
node_graph_generation -->|"adds concepts"| node_language_lessons
node_developer -->|"opens dashboard"| node_dashboard_app
node_dashboard_app -->|"renders graph"| node_structural_graph
node_dashboard_app -->|"renders domains"| node_domain_graph
node_dashboard_app -->|"renders knowledge view"| node_knowledge_graph_view
node_dashboard_app -->|"reads state"| node_dashboard_state
node_dashboard_app -->|"shows details"| node_node_details
node_node_details -.->|"shows source"| node_code_viewer
node_dashboard_state -->|"searches nodes"| node_search
node_developer -->|"requests impact"| node_diff_analysis
node_developer -->|"asks questions"| node_chat
node_chat -->|"builds context"| node_chat_context
node_chat_context -->|"finds relevant nodes"| node_search
node_developer -->|"requests explanation"| node_explanations
node_developer -->|"requests guide"| node_onboarding
node_developer -->|"analyzes wiki"| node_knowledge_import
node_knowledge_import -->|"creates graph"| node_knowledge_graph_view
node_developer -.->|"scans design"| node_figma_import

click node_analysis_pipeline "https://github.com/egonex-ai/understand-anything/tree/main/understand-anything-plugin/skills/understand"
click node_structure_extraction "https://github.com/egonex-ai/understand-anything/blob/main/understand-anything-plugin/skills/understand/extract-structure.mjs"
click node_language_plugins "https://github.com/egonex-ai/understand-anything/tree/main/understand-anything-plugin/packages/core/src/plugins"
click node_graph_generation "https://github.com/egonex-ai/understand-anything/blob/main/understand-anything-plugin/packages/core/src/analyzer/graph-builder.ts"
click node_persistence "https://github.com/egonex-ai/understand-anything/tree/main/understand-anything-plugin/packages/core/src/persistence"
click node_incremental "https://github.com/egonex-ai/understand-anything/blob/main/understand-anything-plugin/skills/understand/prepare-incremental.mjs"
click node_layer_detection "https://github.com/egonex-ai/understand-anything/blob/main/understand-anything-plugin/packages/core/src/analyzer/layer-detector.ts"
click node_tour_generation "https://github.com/egonex-ai/understand-anything/blob/main/understand-anything-plugin/packages/core/src/analyzer/tour-generator.ts"
click node_language_lessons "https://github.com/egonex-ai/understand-anything/blob/main/understand-anything-plugin/packages/core/src/analyzer/language-lesson.ts"
click node_dashboard_app "https://github.com/egonex-ai/understand-anything/blob/main/understand-anything-plugin/packages/dashboard/src/App.tsx"
click node_dashboard_state "https://github.com/egonex-ai/understand-anything/blob/main/understand-anything-plugin/packages/dashboard/src/store.ts"
click node_structural_graph "https://github.com/egonex-ai/understand-anything/blob/main/understand-anything-plugin/packages/dashboard/src/components/GraphView.tsx"
click node_domain_graph "https://github.com/egonex-ai/understand-anything/blob/main/understand-anything-plugin/packages/dashboard/src/components/DomainGraphView.tsx"
click node_knowledge_graph_view "https://github.com/egonex-ai/understand-anything/blob/main/understand-anything-plugin/packages/dashboard/src/components/KnowledgeGraphView.tsx"
click node_node_details "https://github.com/egonex-ai/understand-anything/blob/main/understand-anything-plugin/packages/dashboard/src/components/NodeInfo.tsx"
click node_code_viewer "https://github.com/egonex-ai/understand-anything/blob/main/understand-anything-plugin/packages/dashboard/src/components/CodeViewer.tsx"
click node_search "https://github.com/egonex-ai/understand-anything/blob/main/understand-anything-plugin/packages/core/src/search.ts"
click node_semantic_search "https://github.com/egonex-ai/understand-anything/blob/main/understand-anything-plugin/packages/core/src/embedding-search.ts"
click node_diff_analysis "https://github.com/egonex-ai/understand-anything/blob/main/understand-anything-plugin/src/diff-analyzer.ts"
click node_chat_context "https://github.com/egonex-ai/understand-anything/blob/main/understand-anything-plugin/src/context-builder.ts"
click node_chat "https://github.com/egonex-ai/understand-anything/blob/main/understand-anything-plugin/src/understand-chat.ts"
click node_explanations "https://github.com/egonex-ai/understand-anything/blob/main/understand-anything-plugin/src/explain-builder.ts"
click node_onboarding "https://github.com/egonex-ai/understand-anything/blob/main/understand-anything-plugin/src/onboard-builder.ts"
click node_knowledge_import "https://github.com/egonex-ai/understand-anything/blob/main/understand-anything-plugin/skills/understand-knowledge/parse-knowledge-base.py"
click node_figma_import "https://github.com/egonex-ai/understand-anything/tree/main/understand-anything-plugin/packages/core/src/figma"

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_analysis_pipeline,node_structure_extraction,node_language_plugins,node_graph_generation,node_persistence,node_incremental toneBlue
class node_layer_detection,node_tour_generation,node_language_lessons toneAmber
class node_dashboard_app,node_dashboard_state,node_structural_graph,node_domain_graph,node_knowledge_graph_view,node_node_details,node_code_viewer,node_search,node_semantic_search toneMint
class node_diff_analysis,node_chat_context,node_chat,node_explanations,node_onboarding toneRose
class node_knowledge_import,node_figma_import,node_developer toneIndigo
```

## Components

### Analysis and Graphs

- [Project Analysis](https://github.com/egonex-ai/understand-anything/tree/main/understand-anything-plugin/skills/understand): `understand-anything-plugin/skills/understand`
- [Structure Extraction](https://github.com/egonex-ai/understand-anything/blob/main/understand-anything-plugin/skills/understand/extract-structure.mjs): `understand-anything-plugin/skills/understand/extract-structure.mjs`
- [Language Parsers](https://github.com/egonex-ai/understand-anything/tree/main/understand-anything-plugin/packages/core/src/plugins): `understand-anything-plugin/packages/core/src/plugins`
- [Graph Generation](https://github.com/egonex-ai/understand-anything/blob/main/understand-anything-plugin/packages/core/src/analyzer/graph-builder.ts): `understand-anything-plugin/packages/core/src/analyzer/graph-builder.ts`
- [Graph Persistence](https://github.com/egonex-ai/understand-anything/tree/main/understand-anything-plugin/packages/core/src/persistence): `understand-anything-plugin/packages/core/src/persistence`
- [Incremental Updates](https://github.com/egonex-ai/understand-anything/blob/main/understand-anything-plugin/skills/understand/prepare-incremental.mjs): `understand-anything-plugin/skills/understand/prepare-incremental.mjs`

### Graph Enrichment

- [Layer Detection](https://github.com/egonex-ai/understand-anything/blob/main/understand-anything-plugin/packages/core/src/analyzer/layer-detector.ts): `understand-anything-plugin/packages/core/src/analyzer/layer-detector.ts`
- [Guided Tours](https://github.com/egonex-ai/understand-anything/blob/main/understand-anything-plugin/packages/core/src/analyzer/tour-generator.ts): `understand-anything-plugin/packages/core/src/analyzer/tour-generator.ts`
- [Language Concepts](https://github.com/egonex-ai/understand-anything/blob/main/understand-anything-plugin/packages/core/src/analyzer/language-lesson.ts): `understand-anything-plugin/packages/core/src/analyzer/language-lesson.ts`

### Dashboard Exploration

- [Dashboard App](https://github.com/egonex-ai/understand-anything/blob/main/understand-anything-plugin/packages/dashboard/src/App.tsx): `understand-anything-plugin/packages/dashboard/src/App.tsx`
- [Dashboard State](https://github.com/egonex-ai/understand-anything/blob/main/understand-anything-plugin/packages/dashboard/src/store.ts): `understand-anything-plugin/packages/dashboard/src/store.ts`
- [Structural Graph](https://github.com/egonex-ai/understand-anything/blob/main/understand-anything-plugin/packages/dashboard/src/components/GraphView.tsx): `understand-anything-plugin/packages/dashboard/src/components/GraphView.tsx`
- [Domain Graph](https://github.com/egonex-ai/understand-anything/blob/main/understand-anything-plugin/packages/dashboard/src/components/DomainGraphView.tsx): `understand-anything-plugin/packages/dashboard/src/components/DomainGraphView.tsx`
- [Knowledge Graph View](https://github.com/egonex-ai/understand-anything/blob/main/understand-anything-plugin/packages/dashboard/src/components/KnowledgeGraphView.tsx): `understand-anything-plugin/packages/dashboard/src/components/KnowledgeGraphView.tsx`
- [Node Details](https://github.com/egonex-ai/understand-anything/blob/main/understand-anything-plugin/packages/dashboard/src/components/NodeInfo.tsx): `understand-anything-plugin/packages/dashboard/src/components/NodeInfo.tsx`
- [Code Viewer](https://github.com/egonex-ai/understand-anything/blob/main/understand-anything-plugin/packages/dashboard/src/components/CodeViewer.tsx): `understand-anything-plugin/packages/dashboard/src/components/CodeViewer.tsx`
- [Graph Search](https://github.com/egonex-ai/understand-anything/blob/main/understand-anything-plugin/packages/core/src/search.ts): `understand-anything-plugin/packages/core/src/search.ts`
- [Semantic Search](https://github.com/egonex-ai/understand-anything/blob/main/understand-anything-plugin/packages/core/src/embedding-search.ts): `understand-anything-plugin/packages/core/src/embedding-search.ts`

### Developer Assistance

- [Diff Impact](https://github.com/egonex-ai/understand-anything/blob/main/understand-anything-plugin/src/diff-analyzer.ts): `understand-anything-plugin/src/diff-analyzer.ts`
- [Chat Context](https://github.com/egonex-ai/understand-anything/blob/main/understand-anything-plugin/src/context-builder.ts): `understand-anything-plugin/src/context-builder.ts`
- [Codebase Chat](https://github.com/egonex-ai/understand-anything/blob/main/understand-anything-plugin/src/understand-chat.ts): `understand-anything-plugin/src/understand-chat.ts`
- [Code Explanations](https://github.com/egonex-ai/understand-anything/blob/main/understand-anything-plugin/src/explain-builder.ts): `understand-anything-plugin/src/explain-builder.ts`
- [Onboarding Guide](https://github.com/egonex-ai/understand-anything/blob/main/understand-anything-plugin/src/onboard-builder.ts): `understand-anything-plugin/src/onboard-builder.ts`

### Knowledge and Design

- [Knowledge Base Analysis](https://github.com/egonex-ai/understand-anything/blob/main/understand-anything-plugin/skills/understand-knowledge/parse-knowledge-base.py): `understand-anything-plugin/skills/understand-knowledge/parse-knowledge-base.py`
- [Figma Analysis](https://github.com/egonex-ai/understand-anything/tree/main/understand-anything-plugin/packages/core/src/figma): `understand-anything-plugin/packages/core/src/figma`

### Other components

- **Developer**

## Connections

- Developer → Project Analysis: starts analysis (evidence: `README.md`)
- Project Analysis → Structure Extraction: extracts structure (evidence: `README.md`)
- Structure Extraction → Language Parsers: parses languages
- Project Analysis → Graph Generation: builds graph (evidence: `README.md`)
- Graph Generation → Graph Persistence: saves graph (evidence: `README.md`)
- Project Analysis → Incremental Updates: updates changed files (evidence: `README.md`)
- Graph Generation → Layer Detection: groups layers (evidence: `README.md`)
- Graph Generation → Guided Tours: generates tours (evidence: `README.md`)
- Graph Generation → Language Concepts: adds concepts (evidence: `README.md`)
- Developer → Dashboard App: opens dashboard (evidence: `README.md`)
- Dashboard App → Structural Graph: renders graph (evidence: `understand-anything-plugin/packages/dashboard/src/App.tsx`)
- Dashboard App → Domain Graph: renders domains (evidence: `understand-anything-plugin/packages/dashboard/src/App.tsx`)
- Dashboard App → Knowledge Graph View: renders knowledge view (evidence: `understand-anything-plugin/packages/dashboard/src/App.tsx`)
- Dashboard App → Dashboard State: reads state (evidence: `understand-anything-plugin/packages/dashboard/src/App.tsx`)
- Dashboard App → Node Details: shows details (evidence: `understand-anything-plugin/packages/dashboard/src/App.tsx`)
- Node Details → Code Viewer: shows source
- Dashboard State → Graph Search: searches nodes (evidence: `understand-anything-plugin/packages/dashboard/src/store.ts`)
- Developer → Diff Impact: requests impact (evidence: `README.md`)
- Developer → Codebase Chat: asks questions (evidence: `README.md`)
- Codebase Chat → Chat Context: builds context (evidence: `understand-anything-plugin/src/understand-chat.ts`)
- Chat Context → Graph Search: finds relevant nodes (evidence: `understand-anything-plugin/src/context-builder.ts`)
- Developer → Code Explanations: requests explanation (evidence: `README.md`)
- Developer → Onboarding Guide: requests guide (evidence: `README.md`)
- Developer → Knowledge Base Analysis: analyzes wiki (evidence: `README.md`)
- Knowledge Base Analysis → Knowledge Graph View: creates graph (evidence: `README.md`)
- Developer → Figma Analysis: scans design (evidence: `README.md`)