llm-wiki-starter

A minimal Obsidian-compatible starter vault for experimenting with LLM-maintained wikis, inspired by Andrej Karpathy's LLM wiki gist.

llm-wiki-starter

A minimal Obsidian-compatible starter vault for experimenting with LLM-maintained wikis, inspired by Andrej Karpathy's LLM wiki gist.

This is not an app, plugin, or automation framework. It is a small set of folders, Markdown templates, and operating instructions that help an LLM maintain a wiki over time.

The basic idea:

  • Put raw, unchanged materials in 02-sources/.
  • Ask an LLM to digest them into linked Markdown pages in 03-wiki/.
  • Keep navigation in 04-indexes/index.md.
  • Keep a running activity trail in 05-logs/log.md.
  • Use 00-system/AGENTS.md as the working contract for the LLM.

Suggested Workflow

  1. Drop a new article, transcript, note, PDF summary, or meeting note into 01-inbox/ or 02-sources/.
  2. Ask your LLM: Follow 00-system/AGENTS.md and ingest this source into the wiki.
  3. Review the generated pages and links.
  4. Keep asking questions against the wiki. When an answer is durable, ask the LLM to write it back into 03-wiki/questions/ or update the relevant concept page.
  5. Periodically ask the LLM to run a wiki lint pass.

Copy-Paste Prompts

Ingest a new source:

Follow 00-system/AGENTS.md and ingest 02-sources/source-title.md into the wiki.
Update relevant wiki pages, the index, and the log.

Ask a question against the wiki:

Search this vault and answer: <your question>.
Cite relevant wiki and source pages. If the answer is durable, suggest a question page to write back.

Run a maintenance pass:

Follow the lint workflow in 00-system/AGENTS.md.
Check this vault for missing sources, duplicate pages, stale TODOs, broken links, and missing index entries.
Write findings to 05-logs/lint.md.

Folder Map

  • 00-system/: instructions, schema, conventions, and maintenance rules for the LLM.
  • 01-inbox/: temporary holding area for rough notes and unprocessed material.
  • 02-sources/: original source material. Treat as mostly read-only.
  • 03-wiki/: synthesized, linked knowledge pages.
  • 04-indexes/: human and LLM navigation pages.
  • 05-logs/: append-only activity logs.
  • templates/: page templates.

Examples

The root vault is intentionally empty. A small demo based on Karpathy's gist lives in examples/karpathy-gist-demo/.

You can copy files from the example into the root vault if you want to see the pattern in action, or ignore the example and start from scratch.

Limitations

  • This does not automate ingestion by itself.
  • This does not replace human review.
  • The quality of the wiki depends on the LLM, the instructions, and the care taken with sources.
  • The folder structure is a convention, not a database schema.

Acknowledgements

Inspired by Andrej Karpathy's LLM wiki gist: https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f

This project is unofficial and not affiliated with Andrej Karpathy.

License

MIT

Related

How to Install

  1. Download the ZIP or clone the repository
  2. Open the folder as a vault in Obsidian (File → Open Vault)
  3. Obsidian will prompt you to install required plugins

Stats

Stars

1

Forks

0

License

MIT

Last updated 2mo ago

Categories