# wpzero/karpathy-llm-wiki architecture

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

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

## Overview

This repository packages an agent skill for maintaining a compounding, file-based LLM wiki. The main workflow is ingesting a source into raw storage, compiling durable wiki pages, and updating indexes and logs; users can also query the wiki and lint it. Relationships below are based on README documentation only, since no source excerpts were provided.

Main entry points: [`SKILL.md`](https://github.com/wpzero/karpathy-llm-wiki/blob/main/SKILL.md) (Wiki skill), [`references/index-template.md`](https://github.com/wpzero/karpathy-llm-wiki/blob/main/references/index-template.md) (Wiki indexes), [`README.md`](https://github.com/wpzero/karpathy-llm-wiki/blob/main/README.md) (Raw archive), [`references/concept-template.md`](https://github.com/wpzero/karpathy-llm-wiki/blob/main/references/concept-template.md) (Concept pages)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Agent workflow"]
  node_skill["Wiki skill<br/>[SKILL.md]"]
  node_query["Wiki query<br/>[SKILL.md]"]
  node_lint["Wiki lint<br/>[SKILL.md]"]
end

subgraph group_content["Wiki content"]
  node_raw[("Raw archive<br/>[README.md]")]
  node_summary["Source summaries"]
  node_entities["Entity pages<br/>[entity-template.md]"]
  node_concepts["Concept pages"]
  node_comparisons["Comparison pages"]
  node_syntheses["Synthesis pages"]
end

subgraph group_state["Wiki state"]
  node_index["Wiki indexes<br/>[index-template.md]"]
  node_log["Operation log<br/>[README.md]"]
end

subgraph group_schemas["Page templates"]
  node_archive["Archive pages"]
  node_rawtemplate["Raw page template<br/>[raw-template.md]"]
end

node_human(("Human curator"))
node_source(("External source"))

node_human -->|"requests ingest"| node_skill
node_source -->|"provides source"| node_skill
node_skill -->|"saves source"| node_raw
node_skill -->|"compiles summary"| node_summary
node_skill -->|"compiles entities"| node_entities
node_skill -->|"compiles concepts"| node_concepts
node_skill -->|"compiles comparisons"| node_comparisons
node_skill -->|"compiles syntheses"| node_syntheses
node_skill -->|"updates index"| node_index
node_skill -->|"appends log"| node_log
node_human -->|"asks question"| node_query
node_query -->|"reads index"| node_index
node_query -->|"finds pages"| node_concepts
node_query -->|"cites pages"| node_syntheses
node_human -->|"requests lint"| node_lint
node_lint -->|"checks integrity"| node_index
node_lint -->|"checks coverage"| node_raw

click node_skill "https://github.com/wpzero/karpathy-llm-wiki/blob/main/SKILL.md"
click node_raw "https://github.com/wpzero/karpathy-llm-wiki/blob/main/README.md"
click node_summary "https://github.com/wpzero/karpathy-llm-wiki/blob/main/references/summary-template.md"
click node_entities "https://github.com/wpzero/karpathy-llm-wiki/blob/main/references/entity-template.md"
click node_concepts "https://github.com/wpzero/karpathy-llm-wiki/blob/main/references/concept-template.md"
click node_comparisons "https://github.com/wpzero/karpathy-llm-wiki/blob/main/references/comparison-template.md"
click node_syntheses "https://github.com/wpzero/karpathy-llm-wiki/blob/main/references/synthesis-template.md"
click node_index "https://github.com/wpzero/karpathy-llm-wiki/blob/main/references/index-template.md"
click node_log "https://github.com/wpzero/karpathy-llm-wiki/blob/main/README.md"
click node_query "https://github.com/wpzero/karpathy-llm-wiki/blob/main/SKILL.md"
click node_lint "https://github.com/wpzero/karpathy-llm-wiki/blob/main/SKILL.md"
click node_archive "https://github.com/wpzero/karpathy-llm-wiki/blob/main/references/archive-template.md"
click node_rawtemplate "https://github.com/wpzero/karpathy-llm-wiki/blob/main/references/raw-template.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_skill,node_query,node_lint toneBlue
class node_raw,node_summary,node_entities,node_concepts,node_comparisons,node_syntheses toneAmber
class node_index,node_log toneMint
class node_archive,node_rawtemplate toneRose
class node_human,node_source toneIndigo
```

## Components

### Agent workflow

- [Wiki skill](https://github.com/wpzero/karpathy-llm-wiki/blob/main/SKILL.md): `SKILL.md`
- [Wiki query](https://github.com/wpzero/karpathy-llm-wiki/blob/main/SKILL.md): `SKILL.md`
- [Wiki lint](https://github.com/wpzero/karpathy-llm-wiki/blob/main/SKILL.md): `SKILL.md`

### Wiki content

- [Raw archive](https://github.com/wpzero/karpathy-llm-wiki/blob/main/README.md): `README.md`
- [Source summaries](https://github.com/wpzero/karpathy-llm-wiki/blob/main/references/summary-template.md): `references/summary-template.md`
- [Entity pages](https://github.com/wpzero/karpathy-llm-wiki/blob/main/references/entity-template.md): `references/entity-template.md`
- [Concept pages](https://github.com/wpzero/karpathy-llm-wiki/blob/main/references/concept-template.md): `references/concept-template.md`
- [Comparison pages](https://github.com/wpzero/karpathy-llm-wiki/blob/main/references/comparison-template.md): `references/comparison-template.md`
- [Synthesis pages](https://github.com/wpzero/karpathy-llm-wiki/blob/main/references/synthesis-template.md): `references/synthesis-template.md`

### Wiki state

- [Wiki indexes](https://github.com/wpzero/karpathy-llm-wiki/blob/main/references/index-template.md): `references/index-template.md`
- [Operation log](https://github.com/wpzero/karpathy-llm-wiki/blob/main/README.md): `README.md`

### Page templates

- [Archive pages](https://github.com/wpzero/karpathy-llm-wiki/blob/main/references/archive-template.md): `references/archive-template.md`
- [Raw page template](https://github.com/wpzero/karpathy-llm-wiki/blob/main/references/raw-template.md): `references/raw-template.md`

### Other components

- **Human curator**
- **External source**

## Connections

- Human curator → Wiki skill: requests ingest (evidence: `README.md`)
- External source → Wiki skill: provides source (evidence: `README.md`)
- Wiki skill → Raw archive: saves source (evidence: `README.md`)
- Wiki skill → Source summaries: compiles summary (evidence: `README.md`)
- Wiki skill → Entity pages: compiles entities (evidence: `README.md`)
- Wiki skill → Concept pages: compiles concepts (evidence: `README.md`)
- Wiki skill → Comparison pages: compiles comparisons (evidence: `README.md`)
- Wiki skill → Synthesis pages: compiles syntheses (evidence: `README.md`)
- Wiki skill → Wiki indexes: updates index (evidence: `README.md`)
- Wiki skill → Operation log: appends log (evidence: `README.md`)
- Human curator → Wiki query: asks question (evidence: `README.md`)
- Wiki query → Wiki indexes: reads index (evidence: `README.md`)
- Wiki query → Concept pages: finds pages (evidence: `README.md`)
- Wiki query → Synthesis pages: cites pages (evidence: `README.md`)
- Human curator → Wiki lint: requests lint (evidence: `README.md`)
- Wiki lint → Wiki indexes: checks integrity (evidence: `README.md`)
- Wiki lint → Raw archive: checks coverage (evidence: `README.md`)