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:

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.