---
title: Wiki Schema
created: '2026-05-13'
updated: '2026-05-25'
type: 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/`:
```yaml
---
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:
```yaml
---
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` `vps`
- `obsidian` `vault` `wiki` `ingest`
- `media-pipeline` `arr`

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
```