[2026-05-23] taiga sync: family/logs/vault-sync-2026-05-22.md wiki/SCHEMA.md wiki/concepts/vault-agent-integration.md wiki/htpc-bazzite-proton.md wiki/index.md
This commit is contained in:
-124
@@ -1,124 +0,0 @@
|
||||
---
|
||||
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
|
||||
```
|
||||
Reference in New Issue
Block a user