Uozhan Wiki Schema
Structure (Karpathy 3-Layer)
HOME.md (this page — hub)
├── domains/{domain}.md (20 hub pages — farm, construction, ...)
│ └── domains/{category}/{entry}.md (decision, fact, insight, expert_opinion)
├── index.md (full catalog)
└── SCHEMA.md (this file)
Naming Rules
- Filenames: kebab-case, transliterated (Russian → Latin via
_transliterate())
- No colons in filenames (replaced with em-dash by
_sanitize_title())
- Categories:
decision, fact, insight, expert_opinion, budget, timeline, state, negotiation
Content Rules
- Every entry must have YAML frontmatter with
domain, category, tags
- Tags must include the domain name (e.g.,
farm, construction)
- Domain hub pages list all child entries with
wikilinks
- Every file must be reachable from HOME via chain of wikilinks
Wiki Sync
- Source of truth: Turso
system_knowledge table
wiki_sync() recreates files from Turso entries- Local-only files (HOME.md, index.md, SCHEMA.md, hub pages) are NOT recreated by sync
Cross-References
- Platform wiki: HOME (platform docs)
- Client platform: neurbay
- System map: SYSTEM_MAP