RonanCodes/wiki-templates

Wiki Page Templates

Standard templates for all wiki page types. Every page created or updated in a vault MUST follow these conventions.

Universal Frontmatter (all page types)

Every wiki page has this base frontmatter:

---
title: "Page Title"
date-created: YYYY-MM-DD
date-modified: YYYY-MM-DD
page-type: source-note | entity | concept | comparison | summary
domain:
  - vault-default-domain
tags:
  - relevant-tag
sources:
  - raw/filename.md
  - https://original-url.com
related:
  - "[[related-page-name]]"
---

Rules:

• domain always includes the vault's default domain tag. Add more if content spans domains.
• sources lists paths to raw/ files AND/OR original URLs. Never empty — every page traces to a source.
• related lists wikilinks to related pages in the wiki.
• date-modified updates whenever the page content changes.

---

Page Type: source-note

A summary of one ingested source. One source-note per source.

Location: wiki/sources/<source-name>.md

Additional frontmatter:

source-url: https://original-url.com
source-type: article | paper | video | tweet | gist | discussion | pdf | book | podcast | presentation
author: "Author Name"
date-accessed: YYYY-MM-DD
raw-file: raw/filename.md

Structure:

# <Source Title>

## Overview
Brief summary of what this source contains and why it matters.

## Key Takeaways
- Takeaway 1
- Takeaway 2
- Takeaway 3

## Detailed Notes
Deeper notes organized by topic. Link to [[entity]] and [[concept]] pages when mentioning them.

## Quotes
> Notable direct quotes with context.

## Sources
- **Raw file:** [filename.md](../raw/filename.md)
- **Original URL:** [source-title](https://original-url.com)
- **Author:** Author Name
- **Accessed:** YYYY-MM-DD

Example: source-note

---
title: "LLM Wiki — Karpathy's Idea File"
date-created: 2026-04-12
date-modified: 2026-04-12
page-type: source-note
domain:
  - ai-research
  - knowledge-management
tags:
  - llm
  - knowledge-base
  - obsidian
sources:
  - raw/karpathy-llm-wiki-gist.md
  - https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f
related:
  - "[[andrej-karpathy]]"
  - "[[llm-knowledge-bases]]"
  - "[[obsidian-workflows]]"
source-url: https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f
source-type: gist
author: "Andrej Karpathy"
date-accessed: 2026-04-12
raw-file: raw/karpathy-llm-wiki-gist.md
---

# LLM Wiki — Karpathy's Idea File

## Overview
A pattern for building personal knowledge bases using LLMs. Instead of RAG, the LLM incrementally builds and maintains a persistent wiki of interlinked markdown files.

## Key Takeaways
- The wiki is a persistent, compounding artifact — not re-derived each query
- Three layers: raw sources, the wiki, the schema (CLAUDE.md)
- Four operations: ingest, query, lint, promote
- [[andrej-karpathy]] uses [[obsidian-workflows]] as the viewer

## Sources
- **Raw file:** [karpathy-llm-wiki-gist.md](../raw/karpathy-llm-wiki-gist.md)
- **Original URL:** [GitHub Gist](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f)
- **Author:** Andrej Karpathy
- **Accessed:** 2026-04-12

---

Page Type: entity

A page about a person, organization, tool, framework, or other named entity.

Location: wiki/entities/<entity-name>.md

Additional frontmatter:

entity-type: person | organization | tool | framework | service | dataset | publication
aliases:
  - "Alternative Name"
  - "Abbreviation"

Structure:

# <Entity Name>

## Overview
What/who this entity is and why it's relevant.

## Key Facts
- Fact 1
- Fact 2

## Relevance
How this entity connects to the vault's domain. What role does it play in the knowledge base?

## Mentions
Pages where this entity appears:
- [[source-note-1]] — context of mention
- [[concept-page]] — how it relates

## Sources
- [[source-that-introduced-entity]]
- [External link](https://url)

Example: entity

---
title: "Andrej Karpathy"
date-created: 2026-04-12
date-modified: 2026-04-12
page-type: entity
domain:
  - ai-research
tags:
  - ai
  - deep-learning
  - tesla
  - openai
sources:
  - raw/karpathy-llm-wiki-gist.md
  - raw/karpathy-viral-tweet.md
related:
  - "[[llm-knowledge-bases]]"
  - "[[obsidian-workflows]]"
entity-type: person
aliases:
  - "Karpathy"
---

# Andrej Karpathy

## Overview
AI researcher. Previously Director of AI at Tesla, founding team at OpenAI, PhD from Stanford. Creator of the [[llm-knowledge-bases]] pattern.

## Key Facts
- Created the LLM Wiki "idea file" pattern (April 2026)
- Original tweet got 55K likes, 6.5K retweets
- Uses [[obsidian-workflows]] as his wiki viewer

## Sources
- [[karpathy-llm-wiki-gist]] — the original idea file
- [[karpathy-viral-tweet]] — the tweet that started it all

---

Page Type: concept

A page about an idea, pattern, technique, or abstract concept.

Location: wiki/concepts/<concept-name>.md

Structure:

# <Concept Name>

## Definition
Clear, concise definition of the concept.

## How It Works
Explanation of the concept, mechanics, or methodology.

## Examples
Concrete examples of the concept in practice.

## Related Concepts
- [[related-concept-1]] — how it relates
- [[related-concept-2]] — how it differs

## Sources
- [[source-note]] — where this concept was discussed
- [External link](https://url)

Example: concept

---
title: "LLM Knowledge Bases"
date-created: 2026-04-12
date-modified: 2026-04-12
page-type: concept
domain:
  - ai-research
  - knowledge-management
tags:
  - llm
  - wiki
  - knowledge-base
  - rag-alternative
sources:
  - raw/karpathy-llm-wiki-gist.md
related:
  - "[[andrej-karpathy]]"
  - "[[rag-vs-wiki]]"
  - "[[obsidian-workflows]]"
---

# LLM Knowledge Bases

## Definition
A pattern where LLMs incrementally build and maintain a persistent wiki of interlinked markdown files, rather than re-deriving knowledge from raw documents on every query (as in RAG).

## How It Works
1. **Ingest**: Source documents are processed into wiki pages
2. **Query**: Questions answered by reading the wiki, not raw docs
3. **Lint**: Periodic health checks for contradictions and gaps
4. **Promote**: Cross-project knowledge transferred between wikis

## Related Concepts
- [[rag-vs-wiki]] — comparison of RAG vs persistent wiki approaches
- [[obsidian-workflows]] — the viewer/IDE for browsing wikis

## Sources
- [[karpathy-llm-wiki-gist]] — original pattern description

---

Page Type: comparison

A synthesis page comparing two or more concepts, tools, or approaches.

Location: wiki/comparisons/<comparison-name>.md

Structure:

# <Thing A> vs <Thing B>

## Summary
One-paragraph synthesis of the comparison.

## Comparison Table
| Aspect | Thing A | Thing B |
|--------|---------|---------|
| ... | ... | ... |

## Analysis
Deeper analysis of tradeoffs, use cases, and recommendations.

## Verdict
When to use each, and which is recommended for what context.

## Sources
- [[source-1]] — evidence for Thing A
- [[source-2]] — evidence for Thing B

Example: comparison

---
title: "RAG vs Persistent Wiki"
date-created: 2026-04-12
date-modified: 2026-04-12
page-type: comparison
domain:
  - ai-research
  - knowledge-management
tags:
  - rag
  - wiki
  - architecture
sources:
  - raw/karpathy-llm-wiki-gist.md
related:
  - "[[llm-knowledge-bases]]"
  - "[[andrej-karpathy]]"
---

# RAG vs Persistent Wiki

## Summary
RAG re-derives knowledge each query from raw chunks. A persistent wiki compiles knowledge once and keeps it current. The wiki compounds; RAG doesn't.

## Comparison Table
| Aspect | RAG | Persistent Wiki |
|--------|-----|-----------------|
| Knowledge accumulation | None — re-derived each time | Compounds with every source |
| Cross-references | Must be found each query | Already maintained |
| Contradictions | Not flagged | Flagged during lint |
| Maintenance cost | Low (just index) | Near-zero (LLM maintains) |
| Setup complexity | Higher (embeddings, vector DB) | Lower (just markdown) |

## Sources
- [[karpathy-llm-wiki-gist]] — original argument for wiki over RAG

---

Page Type: summary

A high-level overview page that synthesizes across multiple sources and pages.

Location: wiki/<summary-name>.md (top level of wiki/)

Structure:

# <Topic> — Summary

## Overview
High-level synthesis of the topic.

## Key Themes
- Theme 1 — brief description
- Theme 2 — brief description

## Open Questions
- Question that needs more research
- Unresolved contradiction between sources

## Sources
- [[source-1]]
- [[source-2]]

---

Cross-Referencing Rules

1. Always link entities and concepts when first mentioned on a page: [[entity-name]]
2. Use the canonical page name as the link text. If an entity has aliases, link to the main page: [[andrej-karpathy|Karpathy]]
3. Update the related frontmatter when adding links between pages
4. Don't over-link — link on first mention per page, not every occurrence