# LLM Wiki Schema: Personal Technical Knowledge Base

This document defines the structure, conventions, and workflows for maintaining the LLM Wiki in this repository.

## Overview
This wiki is an LLM-maintained knowledge base focused on **AI, Databases, Programming, and Knowledge Management**, integrated with **Feynman's 12 Favorite Problems** framework. 
The LLM writes and maintains all files under `wiki/`. The human curates raw sources and directs queries.

## Directory Layout
- `raw/` — Immutable source documents (transcripts, articles, notes). Never modify these.
- `wiki/` — LLM-generated markdown files.
    - `wiki/summaries/` — One summary page per raw source document.
    - `wiki/concepts/` — Concept, strategy, and framework pages.
    - `wiki/entities/` — Entity pages (tools, technologies, organizations, products).
    - `wiki/syntheses/` — Comparison tables, decision frameworks, cross-cutting analyses.
    - `wiki/journal/` — Research or session journal entries.
    - `wiki/presentations/` — Marp slide decks generated from wiki content.
    - `wiki/feynman_problems.md` — Central tracking of long-term problems.
    - `wiki/index.md` — Master catalog and portal to thematic indices.
    - `wiki/indices/` — Thematic and type-based index files.
    - `wiki/log.md` — Append-only activity log.

## File Naming & Format
- **Naming**: All lowercase, hyphens for word separation: `concept-name.md`. No spaces or special characters.
- **Frontmatter**:
  ```yaml
  ---
  title: "Page Title"
  type: concept | entity | summary | synthesis
  tags: [tag1, tag2]
  created: YYYY-MM-DD
  updated: YYYY-MM-DD
  sources: ["[[Source Link]]"]
  confidence: high | medium | low
  ---
  ```

## Required Sections by Page Type

### Summary pages (`wiki/summaries/`)
- `## Key Points` — Bulleted list of main claims/ideas.
- `## Relevant Concepts` — Links to concept pages this source touches.
- `## Source Metadata` — Type of source, author/speaker, date, URL or identifier.

### Concept pages (`wiki/concepts/`)
- `## Definition` — One-paragraph plain-English definition.
- `## How It Works` — Mechanics, process, or structure of the concept.
- `## Key Parameters` — Important variables, dimensions, or factors.
- `## When To Use` — Situations and contexts where this concept applies.
- `## Risks & Pitfalls` — Known failure modes, common mistakes, limitations.
- `## Related Concepts` — Wiki links to related pages.
- `## Sources` — Which raw sources inform this page.

### Entity pages (`wiki/entities/`)
- `## Overview` — What this entity is.
- `## Characteristics` — Key properties, attributes, structure.
- `## Common Strategies` — Links to concept pages for strategies or methods associated with this entity.
- `## Related Entities` — Links to related entity pages.

## Feynman's 12 Problems Framework
We maintain a list of ~12 "Favorite Problems" in `wiki/feynman_problems.md`. Every new piece of information is checked against this list to see if it offers a new insight or connection.

## Workflows

### 1. Ingest
When the user says "ingest [source]" or adds a file to `raw/`:
1. Read the raw source completely.
2. Create `wiki/summaries/<source-slug>.md` with full summary.
3. Identify all concepts, entities, and strategies mentioned.
4. **Feynman Check**: Compare against `wiki/feynman_problems.md` and update it if connections are found.
5. Create/Update concept and entity pages using the required sections.
6. Add cross-links in both directions between all touched pages.
7. Update `wiki/log.md` and relevant indices in `wiki/indices/` (thematic and type-based).
8. Update `wiki/index.md` if new categories are needed.
9. Flag any contradictions with existing content.

### 2. Query
1. Read `wiki/index.md` and relevant thematic indices in `wiki/indices/` to find relevant pages.
2. Synthesize an answer citing specific pages with wiki links.
3. If new insight is found, create a synthesis page in `wiki/syntheses/`.

### 3. Lint
1. Check for orphan pages, stale claims, contradictions, and missing cross-links.
2. Fix automatically where possible; report others.
3. Suggest new sources or topics.

## Rules
- Never modify files in `raw/`.
- All dates in ISO 8601 format: YYYY-MM-DD.
- Use Obsidian-style links: `[[concepts/concept-name]]`.
- Confidence levels: **high** (multiple sources), **medium** (single source), **low** (speculative).
- Polish language for content, English/Technical slugs for filenames.