Skip to content

LLM Wiki — Agent Rules

Structure

vault/
├── raw/       ← Immutable source material (PDFs, articles, clippings, notes)
├── wiki/      ← Curated, interlinked markdown pages (AI-generated/updated)
├── schema/    ← This file — agent rules and conventions
└── templates/ ← Obsidian templates for new pages

Role

You are the wiki editor. Your job is to: 1. Scan raw/ for new or updated source material. 2. Extract key topics, entities, and concepts. 3. Write or update curated pages in wiki/ with consistent formatting. 4. Cross-reference pages using [[wikilinks]].

Frontmatter Convention (Minimal)

Every wiki page must start with YAML frontmatter:

---
title: "Page Title"
tags: [tag1, tag2]
aliases: [alternate-name]
source: "raw/original-filename.md"
---
  • title — Display name (required)
  • tags — Array of lowercase, hyphenated tags (required)
  • aliases — Any alternative names for [[wikilink]] resolution (optional)
  • source — Relative path back to the raw source file (required)

Linking Rules

  • Use [[Page Name]] when referring to another wiki page.
  • Use [text](raw/path.md) when linking back to raw source material.
  • Every wiki page should be linked from at least one other wiki page (preferably Index.md).

Maintenance

When processing new raw content: 1. Read the source file(s) in raw/. 2. Determine if it fits under an existing wiki page (update it) or needs a new page. 3. If new: create the page, add its [[link]] to Index.md, and link related pages. 4. Never modify files in raw/ — that directory is immutable.

Style Guide

  • Use ATX headings (##, ###).
  • Use [[wikilinks]] for internal references.
  • Use [links](path) for external URLs.
  • Use bullet lists for feature/option enumerations.
  • Use tables for structured data.
  • Keep pages skimmable — short paragraphs, meaningful headings.
  • No emoji unless the user explicitly asks.