125 lines
4.0 KiB
Markdown
125 lines
4.0 KiB
Markdown
---
|
|
title: Wiki Schema
|
|
created: '2026-05-13'
|
|
updated: '2026-05-23'
|
|
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`
|
|
- `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
|
|
```
|