llm-wiki/AGENTS.md

LangCode Agent Wiki — Schema

Purpose

Persistent knowledge base for the LangCode Agent project. Maintained entirely by an LLM agent running on Ollama (Gemma 2 9B). This wiki sits between raw source documents and your questions — knowledge is compiled once here, then kept current.

Directory Structure

``` llmwiki/ ├── AGENTS.md ← this file (schema) ├── raw/ ← immutable source documents │ ├── articles/ ← web articles, blog posts │ ├── papers/ ← research papers, technical docs │ ├── repos/ ← code repository notes │ └── assets/ ← images, downloads, attachments └── wiki/ ← LLM-generated, interlinked pages ├── index.md ← master catalog (updated every ingest) ├── log.md ← append-only changelog ├── overview.md ← wiki purpose & architecture ├── concepts/ ← one file per key concept ├── entities/ ← one file per person, org, tool ├── sources/ ← one file per source document └── comparisons/ ← comparative analysis pages ```

Conventions

Filenames

• lowercase, hyphens instead of spaces (e.g. `self-attention.md`)
• no special characters, no camelCase
• prefix with date for time-sensitive entries: `2026-05-10-some-event.md`

Page Structure

Every wiki page must follow this template: ```markdown

Title

One-sentence summary of this page.

Tags

`concept` `entity` `source-name` `date`

Body

[Content here — use ## and ### for sections]

Related

• page-name — brief description of connection
• another-page — brief description

Sources

• Source Title — relevant passage or page range ```

Ingest Procedure

When a new source is added to `raw/`:

1. Read the source end-to-end
2. Identify key concepts, entities, claims, and data points
3. For each: create or update the relevant wiki page in `wiki/`
4. Add/update cross-references using `wikilinks`
5. Update `wiki/index.md` with new/modified pages
6. Append entry to `wiki/log.md` with format: ```

   YYYY-MM-DD HH:MM — [source filename]

   • Created: [new pages]
   • Updated: [modified pages]
   • Key takeaways: [bullet summary] ```
7. Run the lint checklist (below)

Query Procedure

When asked a question:

1. Read `wiki/index.md` first to identify relevant pages
2. Load only those pages (not the entire wiki at scale)
3. Synthesize answer from compiled wiki knowledge
4. Cite specific wiki pages: `page-name`
5. If the answer is valuable and reusable, file it as a new wiki page

Lint Checklist

Run weekly or after every 5-10 ingests:

• Every page in `wiki/` appears in `index.md`
• Every `wikilink` resolves to an existing file
• No two pages cover the same concept (merge duplicates)
• Conflicting claims between pages are flagged, not silently overwritten
• No orphan pages (pages with zero inbound links)
• All pages follow the template structure above
• Tags are consistent across related pages
• Log entries are present and properly formatted
• Sources in `raw/` that have been updated are reflected in wiki

Conflict Resolution

When sources disagree:

1. Note both claims explicitly on the relevant page
2. Cite both sources
3. Add a "Status" field: `verified` / `disputed` / `unverified`
4. Do NOT silently overwrite — preserve the history of claims

Naming Conventions

• Page titles: Title Case (e.g. "Self-Attention Mechanism")
• Filenames: lowercase-hyphens (e.g. `self-attention-mechanism.md`)
• Tags: lowercase, hyphens (e.g. `#attention-mechanism`)

Growth Targets

• After 10-20 sources: start querying the wiki for answers
• After 50+ sources: consider adding qmd for enhanced search
• After 100+ sources: review and potentially restructure wiki subdirectories