wiki-load

name	wiki-load
description	JIT wiki-context loader: searches project wiki + global wiki for topic. Loads raw pages — no synthesis. Unified retrieval interface for all knowledge tiers. AUTOMATICALLY INVOKE when: "what do we know about", "load context for", "pull in wiki context", "find in wiki", "look up in the wiki", "load the wiki page for", "what's in the wiki about", "load knowledge about" PROACTIVELY INVOKE when: wiki-notify injects WIKI_PARTIAL previews and current task involves planning/designing/debugging/answering those topics — full-page retrieval required before substantive work. Also invoke when entering plan-mode for features touching wiki-documented domains. NOT for: synthesized answers (/wiki-query), source ingestion (/wiki-ingest)
model	sonnet
allowed-tools	Bash, Read, Glob, Grep
argument-hint	<topic> [--global] [--project]

/wiki-load — JIT Context Loader (Both Knowledge Tiers)

Load pages from the wiki into context on demand. Searches both the project wiki AND the global wiki (~/.claude/wiki/topics/). Returns raw pages — no synthesis.

Use /wiki-query if you want a synthesized answer with citations.

Step 0 — Parse Arguments

From $ARGUMENTS, extract:

• TOPIC: the search term (required)
• GLOBAL_ONLY: true if --global flag
• PROJECT_ONLY: true if --project flag
• Default (neither flag): search both tiers

Find REPO_ROOT via git rev-parse --show-toplevel if in a repo (for project tier).

Step 0.5 — Log Invocation

If REPO_ROOT was found and $REPO_ROOT/.wiki/log.md exists, append a log entry via Bash:

echo "[$(date '+%Y-%m-%d %H:%M')] WIKI_LOAD session:${CLAUDE_CODE_SESSION_ID:0:8}: /wiki-load $ARGUMENTS" >> "$REPO_ROOT/.wiki/log.md"

Step 1 — Project Tier Search (default or --project)

If not GLOBAL_ONLY and in a git repo with a wiki:

Locate WIKI_DIR (search for .wiki/log.md from git root — matches hook sentinel). If found:

• Grep .wiki/entities/ for TOPIC (case-insensitive) — select up to 3 best matches
• Grep .wiki/sources/ for TOPIC — select up to 2 additional matches
• Prefer entity pages over source pages

Step 2 — Global Tier Search (default or --global)

Check both paths (backward compat during reflect pipeline migration):

• ~/.claude/wiki/topics/
• ~/.claude/reflection-knowledge/topics/

Grep for TOPIC across both directories. Select up to 2 best matches.

Step 3 — Read Pages

Read each matched page in full (max 7 pages total: up to 5 project + 2 global).

Step 3.5 — Reinforce Access (project tier only)

For each project-tier page that was loaded, bump its access_count and last_accessed frontmatter fields via:

${CLAUDE_PLUGIN_ROOT}/tools/wiki-bump-access.sh <abs_path_1> <abs_path_2> ...

Pass all loaded project page paths in a single invocation. Best-effort — ignore errors. Do not bump global-tier pages (no schema for it there).

Step 4 — Present Loaded Context

Print using the output-format character vocabulary:

╔═══════════════════════════════════════╗
║  📚 wiki-load — [TOPIC]               ║
╚═══════════════════════════════════════╝

  Project wiki ([M] pages)
  ├─ 🏠 entities/[slug].md    [first line of overview]
  ├─ 🏠 entities/[slug].md    [first line of overview]
  └─ 🏠 sources/[slug].md     [first line of summary]

  Global wiki ([K] topics)
  ├─ 🌐 topics/[slug].md      [first line of summary]
  └─ 🌐 topics/[slug].md      [first line of summary]

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  [N] pages loaded | /wiki-query for synthesis

After the summary, print each page's full content (this is the actual context injection).

If no matches in either tier:

  ⚠ No wiki pages found for '[TOPIC]'
  ▸ /wiki-ingest <source>  to add project knowledge
  ◉ Global topics auto-added after sessions discussing [TOPIC]

Notes

• /wiki-load loads raw pages — the content appears in context for you to reference
• For synthesized answers with citations, use /wiki-query
• /wiki-load --global <topic> is the replacement for /reflect <topic>