wiki-builder

# Wiki Builder Persistent knowledge base for any topic. Markdown on disk + SQLite FTS5 shadow index. ## When to use - "Start a wiki on <topic>" - "Add this paper / link / note to the <slug> wiki" - "Compile a concept page on X in <slug>" - "What does the <slug> wiki say about Y?" (delegates to wiki-query) - "List my wikis" ## Locations - **Global**: `~/.pro-workflow/wikis/<slug>/` — default, never committed - **Project**: `<project>/.claude/wikis/<slug>/` — pass `--scope project`, committable Both register in the same `~/.pro-workflow/data.db`. ## Flavors | Flavor | Use for | |--------|---------| | `research` | ongoing topic exploration | | `paper` | one-paper deep dive | | `domain` | broad subject area | | `product` | product/tool KB | | `person` | researcher/founder dossier | | `organization` | company/lab profile | | `project` | internal project KB | | `codebase` | symbol/file-aware KB tied to a repo | | `incident` | post-mortem KB | ## Layout ``` <slug>/ ├── wiki.config.md # purpose, audience, page types, style, auto_research block ├── raw/ # untouched source material (PDFs, scrapes, transcripts) ├── wiki/ │ └── index.md # entry point, hand-curated TOC ├── derived/ # generated artifacts (surveys, charts, summaries) ├── prompts/ # per-task prompts (compile-page, lint, query) ├── logs/maintenance-log.md └── sources.md # one row per source: id | url | title | hash | fetched_at ``` Flavor adds folders: `wiki/papers`, `wiki/concepts`, `wiki/people`, `wiki/products`, `wiki/timelines`, `wiki/questions`. ## CLI surface ``` node $SKILL_ROOT/scripts/wiki-cli.js init <slug> --title "X" --flavor research [--scope project] [--root <path>] node $SKILL_ROOT/scripts/wiki-cli.js list node $SKILL_ROOT/scripts/wiki-cli.js page <slug> <rel-path> --title "X" [--type concept|paper|person|...] [--from-file path] node $SKILL_ROOT/scripts/wiki-cli.js reindex <slug> node $SKILL_ROOT/scripts/wiki-cli.js info <slug> ``` `init` runs `init_wiki.sh` (mirrors dair layout) AND registers the wiki in SQLite. `page` writes markdown + upserts FTS row. ## Workflow when invoked 1. Resolve action (init / ingest / compile / list / reindex / info). 2. Read `wiki.config.md` of the target wiki before any compile. 3. Every claim that lands in `wiki/` must cite a row in `sources.md` (one citation = one source row). 4. After page write, call `wiki-cli.js page` so FTS index stays in sync. 5. Append a one-line entry to `logs/maintenance-log.md` per change. 6. Update `wiki/index.md` if new top-level page. ## Quality bar - First page useful immediately, not stub. - Stable slug filenames (`tool-use-benchmarks.md`, not `2026-05-08-notes.md`). - Separate raw source from compiled interpretation. - Cross-link related pages in same wiki via relative links. - Mark speculation with `> SPECULATION:` block. - No duplicate summaries — link existing page instead. - Generated pages stay navigable for future agents. ## Privacy Wikis with `private: true` in config never get fetched from web sources by `wiki-research-loop`. Local raw/ only. ## Auto-research opt-in Phase 3.3.0 ships builder + query only. Loop arrives in 3.3.1. To prep, `wiki.config.md` may include: ```yaml auto_research: enabled: false # flip in 3.3.1 max_pages_per_run: 5 max_depth: 3 budget_usd: 0.50 fetchers: [web, arxiv, github] ``` ## Templates See `templates/` for `wiki.config.md`, `index.md`, prompt files. `init_wiki.sh` copies these into the new wiki root.