# nvk/llm-wiki architecture

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

- Interactive diagram: https://gitdiagram.com/nvk/llm-wiki
- Repository: https://github.com/nvk/llm-wiki

## Overview

llm-wiki is an agent-operated knowledge-work system: users capture and research material, organize it in a wiki hub, then query or export the resulting knowledge. Its primary entry points are the full wiki skill and a separate read-only query skill; the README also documents session memory, collection, compilation, audits, and project handoffs. The graph reflects those documented capabilities, but sampled source is limited to session-hook helpers and a read-only query profile, so links between unsampled workflows are intentionally conservative.

Main entry points: [`plugins/llm-wiki/skills/wiki/SKILL.md`](https://github.com/nvk/llm-wiki/blob/master/plugins/llm-wiki/skills/wiki/SKILL.md) (Wiki Manager), [`plugins/llm-wiki/skills/wiki/references/ingestion.md`](https://github.com/nvk/llm-wiki/blob/master/plugins/llm-wiki/skills/wiki/references/ingestion.md) (Source Ingestion), [`plugins/llm-wiki/hooks/llm_wiki_session.py`](https://github.com/nvk/llm-wiki/blob/master/plugins/llm-wiki/hooks/llm_wiki_session.py) (Session Memory), [`plugins/llm-wiki/skills/wiki-query/SKILL.md`](https://github.com/nvk/llm-wiki/blob/master/plugins/llm-wiki/skills/wiki-query/SKILL.md) (Wiki Query)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Agent Interfaces"]
  node_wiki_skill["Wiki Manager<br/>[SKILL.md]"]
  node_query_skill["Wiki Query<br/>[SKILL.md]"]
  node_wiki_cli["Wiki CLI"]
end

subgraph group_knowledge["Knowledge Workflows"]
  node_ideas["Ideas And Research<br/>[ideas.md]"]
  node_collectors["Collector Catalogs<br/>[portfolio.md]"]
  node_ingestion["Source Ingestion<br/>[ingestion.md]"]
  node_datasets["Datasets<br/>[datasets.md]"]
  node_compilation["Wiki Compilation<br/>[compilation.md]"]
  node_query["Knowledge Query<br/>[query-lite.md]"]
  node_sessions["Session Memory"]
  node_feedback["Feedback<br/>[feedback.md]"]
end

subgraph group_governance["Review And Handoffs"]
  node_audit["Audit And Lint<br/>[linting.md]"]
  node_checkpoints["Project Checkpoints<br/>[checkpoints.md]"]
  node_adapters["Private Adapters<br/>[adapters.md]"]
  node_specialists["Specialist Methods<br/>[specialists.md]"]
end

subgraph group_state["Wiki State"]
  node_hub[("Wiki Hub")]
end

node_user(("User"))
node_external_sources(("External Sources"))
node_agent_runtime(("Agent Runtime"))

node_user -->|"requests work"| node_wiki_skill
node_user -->|"asks lookup"| node_query_skill
node_wiki_skill -->|"supports research"| node_ideas
node_wiki_skill -->|"supports collection"| node_collectors
node_wiki_skill -->|"routes ingestion"| node_ingestion
node_wiki_skill -->|"manages datasets"| node_datasets
node_wiki_skill -->|"supports compilation"| node_compilation
node_wiki_skill -->|"routes query"| node_query
node_wiki_skill -->|"manages sessions"| node_sessions
node_wiki_skill -->|"manages feedback"| node_feedback
node_wiki_skill -->|"runs review"| node_audit
node_wiki_skill -->|"exports handoffs"| node_checkpoints
node_wiki_skill -.->|"routes adapters"| node_adapters
node_wiki_skill -.->|"selects methods"| node_specialists
node_query_skill -->|"reads wiki"| node_hub
node_agent_runtime -.->|"dispatches hooks"| node_sessions
node_sessions -->|"writes session state"| node_hub
node_external_sources -->|"provides material"| node_ingestion
node_ingestion -->|"stores source material"| node_hub
node_compilation -->|"updates wiki"| node_hub
node_query -->|"reads wiki"| node_hub
node_wiki_cli -->|"operates on"| node_hub

click node_wiki_skill "https://github.com/nvk/llm-wiki/blob/master/plugins/llm-wiki/skills/wiki/SKILL.md"
click node_query_skill "https://github.com/nvk/llm-wiki/blob/master/plugins/llm-wiki/skills/wiki-query/SKILL.md"
click node_wiki_cli "https://github.com/nvk/llm-wiki/blob/master/plugins/llm-wiki/bin/llm-wiki"
click node_ideas "https://github.com/nvk/llm-wiki/blob/master/plugins/llm-wiki/skills/wiki/references/ideas.md"
click node_collectors "https://github.com/nvk/llm-wiki/blob/master/plugins/llm-wiki/skills/wiki/references/portfolio.md"
click node_ingestion "https://github.com/nvk/llm-wiki/blob/master/plugins/llm-wiki/skills/wiki/references/ingestion.md"
click node_datasets "https://github.com/nvk/llm-wiki/blob/master/plugins/llm-wiki/skills/wiki/references/datasets.md"
click node_compilation "https://github.com/nvk/llm-wiki/blob/master/plugins/llm-wiki/skills/wiki/references/compilation.md"
click node_query "https://github.com/nvk/llm-wiki/blob/master/plugins/llm-wiki/skills/wiki/references/query-lite.md"
click node_sessions "https://github.com/nvk/llm-wiki/blob/master/plugins/llm-wiki/hooks/llm_wiki_session.py"
click node_feedback "https://github.com/nvk/llm-wiki/blob/master/plugins/llm-wiki/skills/wiki/references/feedback.md"
click node_audit "https://github.com/nvk/llm-wiki/blob/master/plugins/llm-wiki/skills/wiki/references/linting.md"
click node_checkpoints "https://github.com/nvk/llm-wiki/blob/master/plugins/llm-wiki/skills/wiki/references/checkpoints.md"
click node_adapters "https://github.com/nvk/llm-wiki/blob/master/plugins/llm-wiki/skills/wiki/references/adapters.md"
click node_specialists "https://github.com/nvk/llm-wiki/blob/master/plugins/llm-wiki/skills/wiki/references/specialists.md"

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_wiki_skill,node_query_skill,node_wiki_cli,node_user toneBlue
class node_ideas,node_collectors,node_ingestion,node_datasets,node_compilation,node_query,node_sessions,node_feedback toneAmber
class node_audit,node_checkpoints,node_adapters,node_specialists toneMint
class node_hub toneRose
class node_external_sources,node_agent_runtime toneIndigo
```

## Components

### Agent Interfaces

- [Wiki Manager](https://github.com/nvk/llm-wiki/blob/master/plugins/llm-wiki/skills/wiki/SKILL.md): `plugins/llm-wiki/skills/wiki/SKILL.md`
- [Wiki Query](https://github.com/nvk/llm-wiki/blob/master/plugins/llm-wiki/skills/wiki-query/SKILL.md): `plugins/llm-wiki/skills/wiki-query/SKILL.md`
- [Wiki CLI](https://github.com/nvk/llm-wiki/blob/master/plugins/llm-wiki/bin/llm-wiki): `plugins/llm-wiki/bin/llm-wiki`

### Knowledge Workflows

- [Ideas And Research](https://github.com/nvk/llm-wiki/blob/master/plugins/llm-wiki/skills/wiki/references/ideas.md): `plugins/llm-wiki/skills/wiki/references/ideas.md`
- [Collector Catalogs](https://github.com/nvk/llm-wiki/blob/master/plugins/llm-wiki/skills/wiki/references/portfolio.md): `plugins/llm-wiki/skills/wiki/references/portfolio.md`
- [Source Ingestion](https://github.com/nvk/llm-wiki/blob/master/plugins/llm-wiki/skills/wiki/references/ingestion.md): `plugins/llm-wiki/skills/wiki/references/ingestion.md`
- [Datasets](https://github.com/nvk/llm-wiki/blob/master/plugins/llm-wiki/skills/wiki/references/datasets.md): `plugins/llm-wiki/skills/wiki/references/datasets.md`
- [Wiki Compilation](https://github.com/nvk/llm-wiki/blob/master/plugins/llm-wiki/skills/wiki/references/compilation.md): `plugins/llm-wiki/skills/wiki/references/compilation.md`
- [Knowledge Query](https://github.com/nvk/llm-wiki/blob/master/plugins/llm-wiki/skills/wiki/references/query-lite.md): `plugins/llm-wiki/skills/wiki/references/query-lite.md`
- [Session Memory](https://github.com/nvk/llm-wiki/blob/master/plugins/llm-wiki/hooks/llm_wiki_session.py): `plugins/llm-wiki/hooks/llm_wiki_session.py`
- [Feedback](https://github.com/nvk/llm-wiki/blob/master/plugins/llm-wiki/skills/wiki/references/feedback.md): `plugins/llm-wiki/skills/wiki/references/feedback.md`

### Review And Handoffs

- [Audit And Lint](https://github.com/nvk/llm-wiki/blob/master/plugins/llm-wiki/skills/wiki/references/linting.md): `plugins/llm-wiki/skills/wiki/references/linting.md`
- [Project Checkpoints](https://github.com/nvk/llm-wiki/blob/master/plugins/llm-wiki/skills/wiki/references/checkpoints.md): `plugins/llm-wiki/skills/wiki/references/checkpoints.md`
- [Private Adapters](https://github.com/nvk/llm-wiki/blob/master/plugins/llm-wiki/skills/wiki/references/adapters.md): `plugins/llm-wiki/skills/wiki/references/adapters.md`
- [Specialist Methods](https://github.com/nvk/llm-wiki/blob/master/plugins/llm-wiki/skills/wiki/references/specialists.md): `plugins/llm-wiki/skills/wiki/references/specialists.md`

### Wiki State

- **Wiki Hub**

### Other components

- **User**
- **External Sources**
- **Agent Runtime**

## Connections

- User → Wiki Manager: requests work
- User → Wiki Query: asks lookup
- Wiki Manager → Ideas And Research: supports research
- Wiki Manager → Collector Catalogs: supports collection
- Wiki Manager → Source Ingestion: routes ingestion
- Wiki Manager → Datasets: manages datasets
- Wiki Manager → Wiki Compilation: supports compilation
- Wiki Manager → Knowledge Query: routes query
- Wiki Manager → Session Memory: manages sessions
- Wiki Manager → Feedback: manages feedback
- Wiki Manager → Audit And Lint: runs review
- Wiki Manager → Project Checkpoints: exports handoffs
- Wiki Manager → Private Adapters: routes adapters
- Wiki Manager → Specialist Methods: selects methods
- Wiki Query → Wiki Hub: reads wiki
- Agent Runtime → Session Memory: dispatches hooks
- Session Memory → Wiki Hub: writes session state
- External Sources → Source Ingestion: provides material
- Source Ingestion → Wiki Hub: stores source material
- Wiki Compilation → Wiki Hub: updates wiki
- Knowledge Query → Wiki Hub: reads wiki
- Wiki CLI → Wiki Hub: operates on