| name | brain |
| description | Answers questions about your own systems, notes, decisions, runbooks, and
conventions from your governed knowledge brain, returning a qmd:// citation for
every claim — receipts, not recall. Use when you want to know what your brain has
captured about your own architecture, infrastructure, decisions, or conventions
(e.g. "what does my system map say about the proxy", "why did I pick Apache-2.0",
"what's my deploy runbook"). Trigger with "/brain", "ask the brain",
"what do I know about", or "check my knowledge base".
|
| allowed-tools | mcp__governed-brain__brain_search |
| version | 1.2.0 |
| author | Jeremy Longshore <jeremy@intentsolutions.io> |
| license | Apache-2.0 |
| compatibility | Designed for Claude Code; ships with the bobs-big-brain (governed-brain) plugin, which auto-wires the governed-brain MCP server. Works in both modes: local (in-process, needs qmd on PATH) and team (proxies to your team brain when TEAMKB_API_URL is set). Same brain_search either way. |
| tags | ["brain","knowledge","search","citations","governance","local-first","team"] |
| argument-hint | [question] |
Brain — cited answers from your governed knowledge base
Ask your knowledge brain a question and get an answer grounded in your governed
corpus, where every claim carries a qmd:// citation. The brain does not paraphrase
from memory — it retrieves governed memories and cites them, so any answer is
verifiable after the fact.
Overview
This is the read surface of Bob's Big Brain: your files are compiled into
governed memories, governed by deterministic code, and retrieved with citations
by Tobi's qmd (OSS). The brain_search MCP tool fronts that retrieval. Your product
surround is INTKB govern + ICO compile + this plugin — not a fork of qmd.
The job here is to turn a natural-language question into a cited answer — and to refuse
to answer beyond what the citations support.
Prerequisites
- The bobs-big-brain / governed-brain plugin is installed (MCP
governed-brain).
- Mode is automatic. In local mode (default) search runs in-process
against your local
~/.teamkb index — no network, no API key; a compatible qmd
binary must be available (prefer monorepo pin @tobilu/qmd via INTKB / installer).
Operators can use scripts/bbb-qmd from qmd-team-intent-kb so XDG points at the team
index, not personal ~/.cache/qmd. In team mode (TEAMKB_API_URL set) search
proxies to the team brain. Every hit is a qmd:// citation.
Instructions
Step 1: Search the governed corpus
Retrieval is Tobi's qmd (BM25 keyword via the MCP). Prefer short keyword queries
over full sentences.
- Derive 1–4 distinctive nouns/verbs from the user question (drop what/why/how, articles,
auxiliaries, prepositions).
- Call
brain_search with those keywords and scope: "curated" (default promoted knowledge).
brain_search({ query: "SOPS age secrets", scope: "curated" })
The tool returns { source, results: [{ citation, snippet, score, collection }] }.
Each citation is a qmd://COLLECTION/FILENAME URI — the receipt for that hit.
Empty-result ladder (do not stop after one miss):
