wicked-brain 0.4.11 → 0.4.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wicked-brain",
-  "version": "0.4.11",
+  "version": "0.4.12",
   "type": "module",
   "description": "Digital brain as skills for AI coding CLIs — no vector DB, no embeddings, no infrastructure",
   "keywords": [

package/server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wicked-brain-server",
-  "version": "0.4.11",
+  "version": "0.4.12",
   "type": "module",
   "description": "SQLite FTS5 search server for wicked-brain digital knowledge bases",
   "keywords": [

package/skills/wicked-brain-configure/SKILL.md

@@ -86,17 +86,23 @@ Digital brain: {brain_id} | {total} indexed items | {chunks} chunks, {wiki} wiki
 
 ### How to use
 
-- **Before responding**: call `wicked-brain:agent` (context) to surface relevant knowledge
+- **Search/explore**: use `wicked-brain:search` — replaces Grep, Glob, and Agent(Explore) for any open-ended search
+- **Answer questions**: use `wicked-brain:query` — replaces Agent(Explore) for conceptual questions
+- **Surface context**: call `wicked-brain:agent` (context) at the start of any new topic
 - **Capture learnings**: call `wicked-brain:agent` (session-teardown) at session end
 - **Store a decision/pattern/gotcha**: call `wicked-brain:memory` (store mode)
-- **Ask the brain**: call `wicked-brain:query` for cited answers
 - **Available agents**: consolidate, context, session-teardown, onboard (via `wicked-brain:agent`)
 
-### Rules
+### Rules (follow strictly)
 
-- Do NOT read brain files directly — use skills and agents
-- Always pass session_id with search calls for access tracking
-- Capture non-obvious decisions and gotchas as memories
+- **ALWAYS check the brain BEFORE using Grep, Glob, Read, or Agent(Explore)** — for any find, search, explore, explain, or "what is/how does" request
+- Use `wicked-brain:search` for finding content ("find X", "where is Y", "look for Z", "show me W")
+- Use `wicked-brain:query` for questions ("what does X do", "how does Y work", "explain Z")
+- Use `wicked-brain:agent` (context) when starting a new topic or unfamiliar area
+- Only fall back to Grep/Glob for **exact pattern matching** after the brain returns no results
+- Do NOT read brain files directly — always go through skills and agents
+- Always pass `session_id` with search/query calls for access tracking
+- Capture non-obvious decisions, patterns, and gotchas with `wicked-brain:memory`
 ```
 
 ### Step 4: Confirm

package/skills/wicked-brain-init/SKILL.md

@@ -221,9 +221,16 @@ Invoke `wicked-brain:ingest` with:
 
 This indexes the project files so the brain is immediately queryable.
 
-### Step 9: Confirm
+### Step 9: Configure the CLI
+
+Invoke `wicked-brain:configure` to write routing instructions into the active
+CLI's agent config (CLAUDE.md, GEMINI.md, etc.). This is what makes the brain
+the default for search and exploration — do not skip this step.
+
+### Step 10: Confirm
 
 Tell the user:
 "Brain `{name}` is ready at `{brain_path}` — {N} files ingested, {M} chunks indexed.
+CLI configured to route search and explore requests through the brain.
 
 Run `wicked-brain:compile` to synthesize wiki articles from the indexed content."

package/skills/wicked-brain-query/SKILL.md

@@ -3,9 +3,12 @@ name: wicked-brain:query
 description: |
   Answer questions by searching and synthesizing brain content. Dispatches a
   query subagent that searches, reads, follows links, and produces a cited answer.
-  
-  Use when: user asks a question that could be answered from brain content,
-  "ask the brain", "brain query", "what does my brain say about".
+
+  Use instead of Agent(Explore) or reading files directly for any conceptual
+  question: "what does X do", "how does Y work", "explain Z", "tell me about W",
+  "why does X happen", "give me context on Y", or any question that could be
+  answered from indexed knowledge. Always try this before exploring the codebase
+  manually.
 ---
 
 # wicked-brain:query

package/skills/wicked-brain-search/SKILL.md

@@ -4,9 +4,13 @@ description: |
   Search the digital brain for relevant content. Dispatches parallel search
   subagents across local and linked brains. Returns results at depth 0 with
   deeper hints.
+
+  Use instead of Grep/Glob/Agent(Explore) for any open-ended search or
+  exploration: "find X", "search for Y", "look for Z", "where is W used",
+  "show me anything about X", "explore Y", "what files relate to Z".
   
-  Use when: "search brain for", "find in brain", "brain search", or when
-  looking for specific content across the knowledge base.
+  Only fall back to Grep/Glob for exact symbol or pattern lookup when the
+  brain returns no results.
 ---
 
 # wicked-brain:search