schema

Wiki Schema

This document defines how the wiki is structured, maintained, and used. The LLM (me) owns all wiki content. Alex curates sources, directs analysis, and thinks about what it means.

Directory Structure

wiki/
├── schema.md        ← this file (conventions + workflows)
├── index.md         ← catalog of all pages with summaries
├── log.md           ← chronological record of all activity
├── raw/             ← immutable source material (clipped articles, transcripts)
├── sources/         ← source summary pages (one per ingested item)
├── entities/        ← people, companies, orgs, projects
├── concepts/        ← ideas, techniques, frameworks, patterns
└── synthesis/       ← cross-cutting analysis, evolving theses, Alex's thinking

Page Types

Source Summary (sources/)

One page per ingested source. Immutable after creation (unless the source itself is updated).

• Filename: sources/{slug}.md
• Contains: metadata, key claims, takeaways, extracted entities/concepts
• Links to: entity pages, concept pages it references

Entity (entities/)

A person, company, org, project, or product.

• Filename: entities/{name}.md
• Contains: who/what, key claims across sources, relationships
• Updated incrementally as new sources mention this entity

Concept (concepts/)

An idea, technique, framework, pattern, or debate.

• Filename: concepts/{name}.md
• Contains: definition, key arguments for/against, evidence from sources, open questions
• Updated incrementally as new sources contribute to this concept

Synthesis (synthesis/)

Alex’s evolving thinking. Cross-cutting analyses that connect multiple sources and concepts.

• Filename: synthesis/{topic}.md
• Contains: thesis, supporting evidence, counterarguments, open questions
• These are the most valuable pages — they represent compounded insight
• Updated when new evidence strengthens, challenges, or refines the thesis

Frontmatter

Every page uses YAML frontmatter:

---
type: source | entity | concept | synthesis
created: YYYY-MM-DD
updated: YYYY-MM-DD
sources: []          # source pages that inform this page
tags: []             # freeform tags for Obsidian/Dataview
---

Naming Conventions

• Filenames: lowercase, hyphens for spaces (reward-modeling.md)
• Display names: title case in the H1 heading
• Wikilinks: use display name [[reward-modeling|Reward Modeling]]
• Prefer specific names over generic (rlhf not training-technique-1)

Cross-Linking Rules

• Every source summary must link to at least one entity or concept
• Entity/concept pages must link back to their source summaries
• Synthesis pages must link to the concepts and sources they draw from
• Use [[wikilinks]] for all internal links (Obsidian-native)

Workflows

Ingest (source → wiki)

1. Read the source material
2. Create a source summary page in sources/
3. For each entity mentioned: create or update its page in entities/
4. For each concept discussed: create or update its page in concepts/
5. Check existing synthesis pages — does this source strengthen, challenge, or add nuance?
6. Update index.md with the new page
7. Append to log.md

Ingest Chat/Thought

Same as above, but the “source” is a conversation or idea from Alex.

• Source type in frontmatter: chat or thought
• Capture the insight, not the conversation mechanics
• Attribute to Alex when it’s his original thinking

Query

1. Read index.md to find relevant pages
2. Read those pages
3. Synthesize an answer with [[wikilinks]] as citations
4. If the answer is valuable: file it as a new synthesis or concept page

Lint

Periodic health check:

• Contradictions between pages
• Stale claims superseded by newer sources
• Orphan pages (no inbound links)
• Concepts mentioned but lacking their own page
• Missing cross-references
• Gaps that suggest new sources to find

Source Types

Type	Origin	Example
article	Readwise, shared links	Blog post, paper, essay
chat	Slack conversations	Substantive discussion with Alex
thought	Alex’s ideas/takes	Hot take, hypothesis, observation
paper	Academic papers	arXiv, conference papers
tweet	Twitter/X bookmarks	Threads, insights
transcript	Meeting notes	Feishu minutes

Constraints

• Never modify files outside wiki/
• Raw sources in raw/ are immutable after saving
• All wiki pages are LLM-written; Alex reads and directs
• When uncertain about Alex’s intent, capture the ambiguity rather than guessing