kb-doctor git:20261010.4e87e24A

Immutable. This exact content never changes and is served at /api/v1/blob/8c2c9185c5c6e1a1.

---
name: kb-doctor
description: "Diagnoses the knowledge base — prerequisites, filtered exchanges, both graphs and every back-pointer — and gives the one printed fix beside each failing line. Handles 'kb doctor', 'check the knowledge base', 'is the memory working', 'diagnose mempalace', 'why does recall come back empty'."
disable-model-invocation: true
---

# Diagnose the knowledge base

1. Check the prerequisites.

   ```bash
   bash "${CLAUDE_PLUGIN_ROOT}/scripts/py.sh" "${CLAUDE_PLUGIN_ROOT}/scripts/kb_setup.py" --check
   ```

2. Check the chain end to end. This exits 1 when anything fails, which is
   expected output rather than an error to retry.

   ```bash
   bash "${CLAUDE_PLUGIN_ROOT}/scripts/py.sh" "${CLAUDE_PLUGIN_ROOT}/scripts/kb_resolve.py" doctor
   ```

3. For every row that reads MISSING or FAIL, repeat the row and put the fix the
   script printed next to it. A missing prerequisite is
   `/graph-mempalace:kb-setup`; an empty or stale graph is
   `/graph-mempalace:kb-compound`; for anything else pass on the printed line
   and name `~/.graph-mempalace/compound.log` as the next place to look.
   `palace` carries the palace path this project uses; it reads "not built yet"
   until the first compound, which is an advisory, and
   `/graph-mempalace:kb-compound` builds it. `palace reachable` lists the wings
   that palace holds — a palace holding one project shows that project's
   dialogue wing. `dialogue wing present` with the detail `exists only in the
   shared 0.1.0 palace` is fixed by `/graph-mempalace:kb-compound`, which moves
   the wing into this project's own palace. `no stale drawers` failing means the
   palace holds drawers whose source file is gitignored or gone; pass on its
   printed `mempalace sync --apply` line exactly as printed, `--palace` and all,
   and say it deletes only those drawers. `mcp launcher python`, from step 1,
   names the Python that starts the MemPalace MCP server; its fix is
   `/graph-mempalace:kb-setup`, which writes `env.GM_PYTHON` into
   `~/.claude/settings.json`, followed by a session restart.
   A `[NOTE]` line is an advisory and never a FAIL: `mcp on PATH` means a
   server is installed but not visible to Claude Code's MCP spawn, and its
   fix is to paste the printed `"env"` line into `~/.claude/settings.json`.
   Step 1 also prints a `palace: <path>` note — pass that path on.
   Done when every MISSING or FAIL row has been repeated with its fix.

4. When both commands come back clean, say so in one line and give the Graph A
   and Graph B node counts the doctor printed.

Complete when both commands have run and every failing line has a fix beside
it.