FROM Wiki Onboarding

What This Is

FROM Wiki is a live, self-updating web interface that renders the llm-wiki/ directory as a browsable Wikipedia-style site. It runs on relik-pi4 and is accessible over tailnet.

URLs

• Wiki UI: https://relik-pi4.tail347b6c.ts.net/ (also http://100.120.38.37:8080/)
• Forgejo repo (content): http://100.120.38.37:3001/from-admin/from-wiki
• Forgejo repo (generator): http://100.120.38.37:3001/from-admin/wiki-gui

How to Add a Page

1. Write a Markdown file anywhere under llm-wiki/wiki/
2. Save it. The cron regenerates every 5 minutes.
3. The page appears in the sidebar and is browsable at the wiki URL.

Example: Create llm-wiki/wiki/projects/new-thing.md and it appears under the "Projects" section.

New Top-Level Section? One Extra Step

If you create a new directory under wiki/ (a new section), add it to section_order in the generator:

• File: /mnt/kitchen/from-house/workspace/d3-tui-pi-teams-proto/wiki-gui/generate_wiki.py
• Search for: section_order
• Add your section name to the list and a label to section_labels

Directories not in section_order still appear in the sidebar — they just get sorted alphabetically at the bottom. Adding to section_order lets you control display order.

After editing the generator, regenerate manually or wait for the cron:

python3 /mnt/kitchen/from-house/workspace/d3-tui-pi-teams-proto/wiki-gui/generate_wiki.py

How to Regenerate

# Manual:
python3 /mnt/kitchen/from-house/workspace/d3-tui-pi-teams-proto/wiki-gui/generate_wiki.py

# Automatic: runs every 5 minutes via cron
# Check: crontab -l

How to Commit Wiki Content

cd /mnt/kitchen/from-house/workspace/d3-tui-pi-teams-proto/llm-wiki/
git add -A
git commit -m 'descriptive message about what changed'
git push

This pushes to the from-wiki repo on Forgejo. The generator reads from the live filesystem, so git commits are for version control — the UI updates from the files on disk.

Page Conventions

• Use Status:, Agent:, and Timestamp UTC: lines at the top of pages to get colored status badges in the UI
• Valid statuses: ANSWERED, CLAIMED, PARTIAL, BLOCKED, OPEN
• Use relative Markdown links to cross-reference other wiki pages: see q-01-pi-teams-fit.md for example syntax
• External links automatically get target blank
• The first level-1 heading becomes the page title and sidebar label

Directory Structure

llm-wiki/
  index.md                    -- Home page
  SCHEMA.md                   -- Page type conventions
  AGENTS.md                   -- Agent instructions
  FROM-WIKI-ONBOARDING.md     -- This file
  log.md                      -- Append-only event log
  wiki/
    research/                 -- Architecture research (Q-00 through Q-13)
    tasks/                    -- Claim board, task lifecycle
    agents/                   -- Agent role definitions
    architecture/             -- Architecture decisions and specs
    concepts/                 -- Concept definitions and patterns
    decisions/                -- Decision records
    toolchain/                -- Tool documentation (LangGraph, KOS, etc.)
    validation/               -- Validation contracts
    <new-section>/            -- Add any new section here
  runs/                       -- Per-run task clocks and artifacts
  sources/                    -- Immutable source notes

Agent Protocol

1. Read AGENTS.md and this file first
2. Check wiki/tasks/claim-board.md for active work
3. Claim one item, work it end-to-end
4. Write your answer into the wiki using the directory structure above
5. Update log.md with what you did
6. Commit your changes to git

Architecture

llm-wiki/ (Markdown source)
    --> generate_wiki.py (Python, cron every 5 min)
llm-wiki-html/ (static HTML)
    --> Python http.server (systemd: wiki-gui.service, port 8080)
    --> Tailscale Serve (HTTPS)
https://relik-pi4.tail347b6c.ts.net/ (browser)

Key paths on relik-pi4:

• Source: /mnt/kitchen/from-house/workspace/d3-tui-pi-teams-proto/llm-wiki/
• Output: /mnt/kitchen/from-house/workspace/d3-tui-pi-teams-proto/llm-wiki-html/
• Generator: /mnt/kitchen/from-house/workspace/d3-tui-pi-teams-proto/wiki-gui/generate_wiki.py
• Templates: /mnt/kitchen/from-house/workspace/d3-tui-pi-teams-proto/wiki-gui/templates/
• CSS: /mnt/kitchen/from-house/workspace/d3-tui-pi-teams-proto/wiki-gui/static/style.css