Skip to content
Public template

About

Starter kit for a Zettelkern vault: an LLM-maintained markdown wiki with typed pages, provenance rules, an append-only log, and a stdlib-only lint script. Karpathy's LLM-wiki pattern, OKF-compatible, works with any agent harness.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Zettelkern starter kit

A clonable skeleton for a Zettelkern vault: a plain-markdown knowledge base that an LLM agent builds, cross-references, and keeps current, with every claim traced to its source. The method is Andrej Karpathy's LLM-wiki pattern in Open Knowledge Format compatible files, plus the production discipline described in the manual at https://zettelkern.com/zettelkern.md. This kit is the free tier, and it is complete: nothing here requires buying anything.

Quickstart: hand it to your agent

  1. Get a copy. Use the green "Use this template" button on GitHub, or clone this repo. Open the folder in your harness: Claude Code, Codex, or any agent that can read files and run git.
  2. Say: "Read AGENTS.md and bootstrap this vault for my domain." The agent asks you three questions (domain, vault language, privacy posture), fills the schema, fetches the founding pattern into raw/, instantiates the templates, and makes one commit.
  3. Hand it your first source and say "ingest it". From then on the loop is: add sources, ask questions, let the agent keep the wiki current.

Health check at any time, no dependencies, standard library only:

python3 tools/lint.py

What is in the box

File Purpose
AGENTS.md the contract: schema, workflows, git conventions, provenance rules
CLAUDE.md one-line pointer so Claude Code lands on the same rules
START_HERE.template.md for the human owner, no terminal required
PROMPTS.md twelve proven prompts, copy-paste ready
tools/lint.py vault health check, single file, stdlib only
docs/AI_DISCLOSURE.template.md institutional AI-usage disclosure skeleton
index.md, log.md, overview.md the spine: catalog, chronology, synthesis
wiki/concepts/example-concept.md the one example page; supersede it once real pages exist
raw/sources.md the immutable layer's rules and pointer register

The pattern is not ours

The gist is not vendored here because it carries no license; the bootstrap downloads it into your own copy instead.

For the human who owns the vault

Start with START_HERE.template.md; your agent renames and fills it during bootstrap. PROMPTS.md has the wording for everything you will ask. You never need a terminal.

License

MIT, copyright 2026 Quellkern e.U. (https://quellkern.com). Questions, or a knowledge base that already exists and needs adapting: [email protected], subject Zettelkern.

About

Starter kit for a Zettelkern vault: an LLM-maintained markdown wiki with typed pages, provenance rules, an append-only log, and a stdlib-only lint script. Karpathy's LLM-wiki pattern, OKF-compatible, works with any agent harness.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages