2.5 KiB
2.5 KiB
Wiki Schema (Personal KB — hermes/personal-wiki on gitea.maukit.com)
Domain
Personal LLM / AI knowledge base maintained via isolated Hermes wiki profile.
Repo: https://gitea.maukit.com/hermes/personal-wiki (shared with floof for push access).
Local root: /opt/data/wiki (cloned git repo).
Agent profile: /opt/data/profiles/wiki/ (isolated — only writes via this profile).
Conventions
- File names: lowercase, hyphens, no spaces
- Every page starts with YAML frontmatter (title, created, updated, type, tags, sources, confidence, contested)
- Use
[[wikilinks]]for internal links (min 2 outbound per page) - Raw sources (
raw/) are immutable; corrections go in wiki pages - Every ingest/update must append to
log.md - Every new page must be added to
index.md - Use
#for headers,---for YAML delimiters - Only tags from the taxonomy below
Tag Taxonomy
- kb: kb, source, reference, note, summary
- domain: personal, workflow, homelab, ai, model, tool, skill, script
- meta: comparison, timeline, open-question, confirmed, contested
- layer: raw, entity, concept, comparison, query
Page Thresholds
- Create page: entity/concept in 2+ sources OR central to 1 source
- Don't create for passing mentions or single-source footnotes
- Update: add new info, bump
updated, note contradictions - Split page when >200 lines
- Archive superseded content to
_archive/
Frontmatter Template
---
title: Page Title
created: YYYY-MM-DD
updated: YYYY-MM-DD
type: entity | concept | comparison | query | summary
tags: [kb, domain-tag, meta-tag]
sources: [raw/articles/file.md]
confidence: high | medium | low
contested: true | false
contradictions: [other-page-slug]
---
Update Policy
- Newer sources supersede older
- Contradictions: note both claims with dates, mark
contested: true, list incontradictions - Always bump
updatedwhen editing - Every edit must update
log.md
Quality Signals
confidence: high→ multi-source, well-corroboratedconfidence: medium→ single source or partial corroborationconfidence: low→ speculative / opinion-heavy / contestedcontested: true→ page has unresolved contradictions (must be resolved before promoting tohigh)
Source Drift Check
Raw files have sha256: (body hash, not frontmatter). Re-ingest must compare hash; skip if identical, update if different.
Access & Sharing
Repo shared with floof (push access, Gitea user id 3). Other agents / hosts read via git clone (public repo); only wiki profile writes. Second Telegram bot deferred.