wicked-brain 0.4.10 → 0.4.12

package/package.json

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

@@ -80,13 +80,23 @@ this resolution. Never compute `_meta/config.json` against the project's `cwd`.
 
 ### Step 1: Ask the user
 
-Compute the default project name from the current working directory basename
-(lowercase, replace non-alphanumerics with hyphens). Then ask:
+**Ask in this exact order — do not reverse the questions:**
 
-1. "What should this project's brain be called?" — Default: `{cwd_basename}`
-2. "Where should it live?" — Default:
-   - macOS/Linux: `~/.wicked-brain/projects/{project_name}`
-   - Windows: `%USERPROFILE%\.wicked-brain\projects\{project_name}`
+First, compute `{cwd_basename}`: take the basename of the current working directory,
+lowercase it, and replace any 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")
+   - Wait for the user's answer (or acceptance of default) before asking question 2.
+
+2. **"Where should it live?"**
+   - Default:
+     - macOS/Linux: `~/.wicked-brain/projects/{project_name}` (where `{project_name}` is the name from question 1)
+     - Windows: `%USERPROFILE%\.wicked-brain\projects\{project_name}`
+   - The default path MUST include the `projects/` subdirectory and the project name.
+     **Never default to just `~/.wicked-brain/`** — that is the parent container, not a brain.
 
 If the user supplies a path that is exactly `~/.wicked-brain` (the parent
 directory, not a project subdirectory), push back: explain the per-project
@@ -211,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