obsidian-vault/wiki/SCHEMA.md

title, created, updated, type

title	created	updated	type
Wiki Schema	2026-05-13	2026-05-23	meta

Wiki Schema

Domain

Knowledge base covering Alex's Personal OS ecosystem: the multi-agent productivity/context system, home infrastructure (Eagle Mac M4, Taiga TrueNAS, Kraken RPi5), personal projects (Reflect app, etc.), and DuckDuckGo work tooling.

In scope: agent architecture, data pipelines, home infra, dev tooling, personal projects, vault management. Out of scope: raw Asana tasks, family documents, ephemeral briefs.

Conventions

• File names: lowercase, hyphens, no spaces (e.g., personal-os-architecture.md)
• Every wiki page starts with YAML frontmatter (see below)
• Use [[wikilinks]] to link between pages (minimum 2 outbound links per page)
• When updating a page, always bump the updated or last_synced date
• Every new page must be added to index.md under the correct section
• Every action must be appended to log.md
• Subdirectories: concepts/ for concept/how-it-works pages, tech/ for infra/tool how-tos, comparisons/ for side-by-side analyses, entities/ for people/orgs/projects, queries/ for filed query results

Frontmatter

Wiki pages synthesised from raw/:

---
source: raw/<filename>
content_hash: <sha256>
namespace: work | personal | family
last_synced: YYYY-MM-DD
confidence: 0.8
tags: [tag1, tag2]
---

Hand-written or agent-synthesised pages:

---
title: Human Readable Title
created: YYYY-MM-DD
updated: YYYY-MM-DD
type: concept | entity | comparison | tech | query
namespace: work | personal | family
tags: [from taxonomy below]
sources: [raw/articles/source.md]
confidence: high | medium | low
---

Confidence ladder:

• 1.0 / high — human-written; agent must never edit these files
• 0.9 — highly structured / authoritative source (schema, infra docs)
• 0.8 / medium — single clear source; default for agent synthesis
• 0.6 / low — inferred or partial content

Pages with confidence: 1.0 are immutable to the wiki-curation agent.

Tag Taxonomy

Personal OS:

• system architecture agent eagle executor pipeline sync
• rules self-modification meta purpose

Work / DDG:

• asana ddg workflow task-management

Infrastructure:

• infra kraken taiga htpc docker nas raspberry-pi
• obsidian vault wiki ingest

Projects:

• reflect-app psychology ios android skip-tools
• project startup

Technical:

• schema postgres database mcp hermes
• debugging pitfalls how-to

Rule: every tag on a page must appear in this taxonomy. Add new tags HERE before using them. Avoid tag sprawl.

Page Thresholds

• Create a page when an entity/concept appears in 2+ sources OR is central to one source
• Add to existing page when a source mentions something already covered
• DON'T create a page for passing mentions or things outside the domain
• Split a page when it exceeds ~200 lines
• Never edit pages with confidence: 1.0

Update Policy

When new information conflicts with existing content:

1. Check dates — newer sources generally supersede older ones
2. If genuinely contradictory, note both positions with dates
3. Never silently overwrite — show what changed

Directory Structure

wiki/
├── SCHEMA.md               ← this file
├── index.md                ← page catalog
├── log.md                  ← action log (append-only)
├── *.md                    ← root-level pages (legacy + core)
├── concepts/               ← how-it-works, design rationale
├── tech/                   ← infra/tool how-tos (device-specific)
├── comparisons/            ← side-by-side analyses
├── entities/               ← people, projects, products
├── queries/                ← filed query results
└── raw/                    ← immutable sources
    ├── inbox/              ← new files to process
    └── inbox/processed/    ← after ingestion