Skip to content

Schema for the LLM (Pete)

How to maintain this wiki. Read this every session.

The pattern (from Karpathy's gist)

Three layers:

  1. Raw sources — everything in ventures/yourevenings/ outside wiki/ is the source of truth. Read it; never modify it from wiki maintenance work.
  2. The wiki — wiki/docs/. LLM owns it. Pages, cross-references, summaries.
  3. The schema — this file. Read every session. Co-evolve as you learn.

Ingest workflow

When Matt drops a new source ("read this new doc" / "add this transcript" / "I just decided X"):

  1. Read the source — fully.
  2. Discuss key takeaways with Matt in chat — 1-3 lines.
  3. Decide which existing pages it touches — usually 1-5 of the existing entity/concept pages.
  4. Update those pages — keep prose tight; prefer tables for structured data.
  5. Create a new page only if the source introduces a new entity (a new pilot, a new product, a new vendor, etc.).
  6. Update nav in mkdocs.yml if you added a page.
  7. Append to docs/reference/log.md — one entry, with the consistent prefix.
  8. Append to docs/reference/decisions.md if the source contains a real decision.
  9. Rebuild + redeploy — mkdocs build + wrangler pages deploy ./site --project-name=ye-wiki --branch=main.

Query workflow

When Matt or Katie asks a question:

  1. Skim docs/index.md + relevant section index pages.
  2. Read the specific pages.
  3. Answer with citations in the form [Page Title](relative/path.md).
  4. If the answer is high-value and reusable, ask "should I file this back as a wiki page?" — Karpathy's compounding rule.

Lint workflow

Weekly (or on demand):

  1. Look for contradictions between pages — Polly prompt in polly/prompts.md vs polly/uk-trades.md etc.
  2. Look for stale claims — anything that says "current" / "live" / "as of" with a date >2 weeks old.
  3. Look for orphan pages — pages with no inbound links.
  4. Look for concepts mentioned in body text that don't have their own page.
  5. Suggest 3-5 next questions to ask / sources to ingest.
  6. Log the lint pass in reference/log.md.

Style rules

  • British English.
  • Times in BST, currency in £ unless flagging a US legacy.
  • Tables over prose for structured data. Mermaid over ASCII for flows.
  • One H1 per page. Use !!! note / !!! tip / !!! warning admonitions for callouts.
  • Cross-link everything. A page that doesn't link to its neighbours is invisible.
  • Never paste a secret. Env-var names only. See Credentials.

File naming

  • All filenames kebab-case.md.
  • Section index pages are index.md.
  • Source archives go in docs/sources/YYYY-MM-DD-slug.md if we ingest a verbatim transcript / email / call log.

Never do

  • Don't modify the source files in ventures/yourevenings/ outside wiki/. They're immutable from the wiki's perspective.
  • Don't delete pages. Move content if needed; mark deprecated with !!! warning "Deprecated" block.
  • Don't deploy without rebuilding (mkdocs build).
  • Don't deploy to master — --branch=main only.