llm-wiki/SCHEMA.md

Wiki Schema

Domain

LLM Wiki の試用・運用メモ。対象は「LLM が保守する持続的な Markdown 知識ベース」というパターン、その運用方法、関連ツール、比較対象。

Conventions

• File names: lowercase, hyphens, no spaces (e.g., llm-wiki-pattern.md)
• Every wiki page starts with YAML frontmatter.
• Use Obsidian-style double-bracket links between pages; aim for at least 2 outbound links per page.
• When updating a page, always bump the updated date.
• Every new page must be added to index.md under the correct section.
• Every action must be appended to log.md.
• Raw sources under raw/ are immutable after ingest.

Frontmatter

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

raw/ Frontmatter

---
source_url: https://example.com/article
ingested: YYYY-MM-DD
sha256: <hex digest of raw body>
---

Tag Taxonomy

• Methods: wiki, knowledge-base, retrieval, synthesis, maintenance
• Tools: obsidian, markdown, git, cli
• Roles: agent, human-in-the-loop
• Meta: comparison, workflow, source

Page Thresholds

• Create a page when an entity/concept is central to one source or appears in 2+ sources.
• Add to an existing page when a source mentions something already covered.
• Do not create pages for passing mentions.
• Split a page when it exceeds ~200 lines.

Update Policy

When new information conflicts with existing content:

1. Check source dates.
2. Note both positions with dates and sources.
3. Mark contested pages with contested: true and/or contradictions:.
4. Flag for user review in lint output.