llm-wiki-bootstrap

LLM Wiki Bootstrap

Build and maintain a personal LLM Wiki: raw evidence stays immutable in raw/, durable knowledge is compiled into wiki/, and SCHEMA.md is the generated wiki's single operating contract.

This file is intentionally short. Load detailed references only for the operation the user requested.

Operating Model

• Keep SCHEMA.md as the single source of truth inside every generated wiki.
• Keep wiki/concept-table.md as the maintained concept map: it complements wiki/index.md by summarizing durable concepts, relationships, sources, status, and maintenance notes.
• Keep CLAUDE.md, AGENTS.md, and .github/copilot-instructions.md as thin pointers to SCHEMA.md; never duplicate operating rules into them.
• Treat raw/ as read-only evidence. Create and update derived knowledge only under wiki/.
• Apply EXTEND.md preferences before bootstrap, ingest, query, lint, or BM25 work.
• Ask only for missing decisions, and batch setup questions into one user prompt when possible.
• Prefer progressive disclosure: read the smallest reference file that can complete the current task.

Intent Router

User intent	Do this	Reference
Create or bootstrap a new wiki	Run preference preflight, gather setup answers, then generate the scaffold and seed files.	references/workflows/bootstrap.md
Ingest one or more sources	Run preference preflight, check the optional BM25 gate, then compile source knowledge into wiki/.	references/workflows/ingest.md
Answer a domain question from the wiki	Run preference preflight, navigate wiki/index.md, use BM25 only as a candidate finder, then cite wiki pages.	references/workflows/query.md
Check wiki health or consistency	Run preference preflight, scan structure and content, report findings, then fix only approved items.	references/workflows/lint.md
Configure or use BM25 search	Load preferences, ask before initialization, create local search files, smoke test, and log results.	references/workflows/bm25.md
Configure preferences	Locate or create EXTEND.md using the schema and template.	references/config/extend-schema.md, references/templates/extend.md

Preference Preflight

Before bootstrap, ingest, query, lint, or BM25 work, read references/config/extend-schema.md and use the first available EXTEND.md in its lookup order. If none exists, run the first-time preference setup and create one from references/templates/extend.md before continuing.

On first use in a session, briefly say which preference file is active. Do not silently use defaults.

Reference Loading Rules

• For bootstrap, read references/workflows/bootstrap.md, then load each template only when creating that file.
• For ingest, query, and lint, read the matching workflow file first; read references/workflows/bm25.md only when preferences or the user request require search behavior.
• For schema generation, read references/templates/schema.md and inject domain snippets from references/templates/domain-page-types.md as needed.
• For pointer files, read references/templates/agent-pointer.md and keep the generated file minimal.
• For BM25 initialization, read references/templates/wiki_fts.py and references/templates/bm25-readme.md only after the user approves initialization.

Package Layout Rules

• Put skill-owned runnable helpers in scripts/ if they are meant to be executed from the installed skill package.
• Put generated-output templates in references/templates/, even when the generated file will become executable after it is copied into the user's wiki.
• Put long procedural documentation in references/workflows/ and configuration schemas in references/config/.
• In this skill, references/templates/wiki_fts.py is a template for the generated wiki's scripts/wiki_fts.py; it is not executed in place by the skill.

Hard Rules

• Never overwrite an existing wiki without explicit user approval.
• Never modify files in raw/ except to create empty scaffold placeholders such as .gitkeep during bootstrap.
• Never answer directly from BM25 snippets; open and read the returned wiki pages first.
• Preserve source language during ingest unless the user asks for a different wiki language.
• Update wiki/index.md and append wiki/log.md whenever wiki content changes.
• If a search index rebuild fails, keep wiki edits, log the failure, and fall back to wiki/index.md plus text search.

Core Outputs

A successful bootstrap creates a wiki root containing:

raw/
wiki/index.md
wiki/concept-table.md
wiki/log.md
wiki/overview.md
SCHEMA.md
.gitignore

Optional outputs depend on setup answers and preferences: runtime pointer files, .vscode/settings.json, scripts/wiki_fts.py, indexes/, and exports/.