Wiki Schema

Domain

This wiki covers research tasks Johannes asks Hermes/Dagobert to perform. It is intentionally broad: AI/LLMs, software, boating, places, websites, project research, market/product research, and any recurring topic that benefits from accumulated notes.

Operating Principle

This wiki follows llm-wiki-pattern inspired by Andrej Karpathy's LLM Wiki idea: raw sources are preserved, then Hermes incrementally compiles knowledge into interlinked markdown pages so research compounds over time instead of being rediscovered from scratch.

Directory Structure

• SCHEMA.md — conventions and rules for this wiki
• index.md — content catalog; read first before research/query work
• log.md — append-only activity log
• raw/ — immutable source captures; do not edit after ingestion
• entities/ — people, organizations, products, places, boats, websites, projects
• concepts/ — topics, ideas, techniques, patterns
• comparisons/ — side-by-side evaluations
• queries/ — substantial research answers worth preserving
• data/ — structured JSON/CSV supporting wiki pages
• _archive/ — superseded pages

Conventions

• File names: lowercase, hyphenated, no spaces.
• Every wiki page starts with YAML frontmatter.
• Use [[wikilinks]] between pages; aim for at least 2 outbound links per page once the wiki has enough pages.
• When updating a page, bump updated.
• Every new page must be listed in index.md.
• Every action must be appended to log.md.
• Raw sources require frontmatter with source_url, ingested, and sha256 of the body.
• Never modify files in raw/ except to add a new immutable source capture or intentionally re-ingest a changed source.
• Use Dagobert pages/HTML summaries when research output would be too long for Telegram chat.
• After creating or updating Markdown pages, run scripts/render-wiki.py from this wiki to generate browser-friendly .html siblings with tappable markdown links and [[wikilinks]].
• Root index.html is the browser catalog; canonical index.md renders to index-md.html to avoid clobbering the landing page.

Frontmatter

---
title: Page Title
created: YYYY-MM-DD
updated: YYYY-MM-DD
type: entity | concept | comparison | query | summary
tags: [tag-from-taxonomy]
sources: [raw/articles/source.md]
confidence: high | medium | low
contested: false
---

Tag Taxonomy

Use only these tags unless this schema is updated first:

• wiki — wiki operations, methodology, knowledge-base structure
• research-method — research workflows, source handling, synthesis methods
• llm — large language models and AI systems
• software — software development and tooling
• website — managed websites and web publishing
• project — Johannes' personal/work projects
• boat — Bingo, docks, marine maintenance, liveaboard systems
• dog — Olaf/Copper care or training research
• place — places, geography, local research
• person — notable people
• organization — companies, labs, institutions
• product — products/services/tools
• comparison — side-by-side analysis
• query — filed research answers
• operations — task/process/management operations

Page Thresholds

• Create a page when an entity/concept is central to a source or appears across multiple sources.
• Add to an existing page when a new source updates something already covered.
• Do not create pages for passing mentions.
• Split pages over roughly 200 lines.
• Mark weak or single-source syntheses as confidence: medium or low.

Research Workflow

1. Orient: read SCHEMA.md, index.md, and recent log.md.
2. Capture raw sources in raw/ with hash frontmatter.
3. Search existing pages before creating new ones.
4. Create/update entity, concept, comparison, or query pages with wikilinks.
5. Update index.md and log.md.
6. Reply to Johannes with a concise summary and file/link list.

Update Policy

When new information conflicts with existing content:

1. Prefer newer/better primary sources, but preserve the older claim with date/source if relevant.
2. If contradiction remains unresolved, set contested: true and describe the conflict.
3. Flag contradictions in the final report to Johannes.