Wiki Schema
Domain
Personal research wiki focused on LLMs, AI agents, model serving, product notes, and adjacent technical exploration.
Conventions
- File names: lowercase, hyphens, no spaces (for example
response-api.md) - Every wiki page starts with YAML frontmatter
- Use
[[wikilinks]]between pages; prefer at least 2 outbound links on substantial pages - When updating a page, always bump the
updateddate - Every new page must be added to
index.md - Every meaningful action must be appended to
log.md - Files under
raw/are immutable source captures; do not edit them after ingestion
Frontmatter
---
title: Page Title
created: YYYY-MM-DD
updated: YYYY-MM-DD
type: entity | concept | comparison | query | summary
tags: [from taxonomy below]
sources: [raw/articles/example-source.md]
---Tag Taxonomy
- model
- architecture
- inference
- training
- evaluation
- benchmark
- agent
- runtime
- tooling
- company
- person
- product
- api
- protocol
- workflow
- serving
- open-source
- research
- writing
- comparison
- query
- note
- deployment
- economics
- safety
Rule: add a tag here before using it in page frontmatter.
Page Thresholds
- Create a page when an entity or concept appears in 2+ sources, or is central to one source
- Add to an existing page when the source mainly extends something already covered
- Do not create pages for passing mentions or things clearly outside this wiki’s scope
- Split pages when they exceed roughly 200 lines
- Archive superseded pages into
_archive/
Entity Pages
Include:
- Overview
- Key facts and dates
- Relationships to other pages
- Source references
Concept Pages
Include:
- Definition
- Current understanding
- Open questions or tensions
- Related pages
Comparison Pages
Include:
- What is being compared and why
- Comparison dimensions, ideally in table form
- Synthesis or verdict
- Sources
Update Policy
When new information conflicts with existing notes:
- Prefer the newer source when it is clearly more current
- If both positions matter, note both with dates and sources
- Flag substantial contradictions explicitly for later review