gabrielmoreira Wiki Builder
Persistent knowledge base for any topic. Markdown on disk + SQLite FTS5 shadow index.
When to use
- "Start a wiki on "
- "Add this paper / link / note to the wiki"
- "Compile a concept page on X in "
- "What does the 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
- Resolve action (init / ingest / compile / list / reindex / info).
- Read
wiki.config.mdof the target wiki before any compile. - Every claim that lands in
wiki/must cite a row insources.md(one citation = one source row). - After page write, call
wiki-cli.js pageso FTS index stays in sync. - Append a one-line entry to
logs/maintenance-log.mdper change. - Update
wiki/index.mdif new top-level page.
Quality bar
- First page useful immediately, not stub.
- Stable slug filenames (
tool-use-benchmarks.md, not2026-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.