wicked-brain 0.4.11 → 0.4.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wicked-brain",
-  "version": "0.4.11",
+  "version": "0.4.13",
   "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.13",
   "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

@@ -80,15 +80,32 @@ this resolution. Never compute `_meta/config.json` against the project's `cwd`.
 
 ### Step 1: Ask the user
 
-**Ask in this exact order — do not reverse the questions:**
+**Ask in this exact order — do not reverse the questions.**
 
-First, compute `{cwd_basename}`: take the basename of the current working directory,
-lowercase it, and replace any non-alphanumeric characters with hyphens.
+First, compute `{cwd_basename}`:
+
+```bash
+# macOS/Linux
+basename "$PWD"
+# Windows PowerShell
+Split-Path -Leaf (Get-Location)
+```
+
+This gives you the name of **the project the user is currently working in** — the repo or
+directory they are about to index. It has nothing to do with wicked-brain, the skill name,
+or any installed tool. For example:
+
+- User is in `/Users/alice/Projects/wicked-bus` → default name is `wicked-bus`
+- User is in `/home/bob/work/my-api` → default name is `my-api`
+- User is in `/Users/mike/Projects/wicked-brain` → default name is `wicked-brain` (only
+  correct if they are literally indexing the wicked-brain repo itself)
+
+Lowercase the result and replace non-alphanumeric characters with hyphens.
 
 Then ask **two questions, in order**:
 
 1. **"What should this project's brain be called?"**
-   - Default: `{cwd_basename}` (the current directory name, not the string "wicked-brain")
+   - Default: `{cwd_basename}` — computed above from the actual current working directory
    - Wait for the user's answer (or acceptance of default) before asking question 2.
 
 2. **"Where should it live?"**
@@ -221,9 +238,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