From a5aff4d1002f665fb62854a5eecca40e30b3c4b3 Mon Sep 17 00:00:00 2001 From: Alexey Martemyanov Date: Thu, 14 May 2026 10:27:42 +0600 Subject: [PATCH] 2026-05-14 wiki: SCHEMA sections+inbox protocol, inbox dir structure --- wiki/SCHEMA.md | 27 ++++++++++++++++++++++++++- 1 file changed, 26 insertions(+), 1 deletion(-) diff --git a/wiki/SCHEMA.md b/wiki/SCHEMA.md index 7d369f02..a6b0a873 100644 --- a/wiki/SCHEMA.md +++ b/wiki/SCHEMA.md @@ -53,6 +53,30 @@ relevant to Alex's specific setup. 6. **Never delete** pages — mark stale content with `> ⚠️ Stale as of YYYY-MM-DD`. 7. **Confidence** < 0.5 = speculation, add disclaimer. > 0.8 = verified fact. +## Sections + +| Subfolder | What goes here | +|-----------|---------------| +| *(root wiki/)* | personal-os infrastructure, architecture, agent rules | +| `concepts/` | abstract topics, tech concepts, methodologies | +| `entities/` | tools, products, services, people | +| `tech/` | development topics relevant to Alex's stack | +| `ideas/` | ideas, hypotheses, open questions | +| `queries/` | filed answers to valuable one-off questions | +| `comparisons/` | side-by-side analyses | +| `raw/inbox/` | drop zone — files here get processed by nightly cron | +| `raw/articles/` | extracted web articles (immutable after write) | +| `raw/papers/` | PDFs and papers (immutable after write) | + +## Inbox Protocol + +Files in `raw/inbox/` are processed nightly by the curation cron: +- `research-[slug]-YYYYMMDD.md` — research request +- `idea-YYYYMMDD-HHMMSS.md` — idea to preserve +- `url-YYYYMMDD-HHMMSS.md` — URL to extract and synthesize +- `note-YYYYMMDD-HHMMSS.md` — plain note or decision +After processing, move to `raw/inbox/processed/`. + ## What to Curate - Architecture changes (new services, infra decisions) @@ -60,9 +84,10 @@ relevant to Alex's specific setup. - Lessons learned from system failures or fixes - Updated tool versions, API changes - New integrations (Tavily, mcpvault, etc.) +- Anything dropped into `raw/inbox/` by Alex or Kraken ## What NOT to Add - Raw task lists (those live in Asana) - Personal/family content (those live in `personal/` and `family/`) -- General knowledge that isn't Alex-specific +- General knowledge that isn't Alex-specific (exception: `tech/` and `ideas/` — those are fine)