claude-brain 0.30.2 → 0.30.3

package/skills/persistent-memory/SKILL.md

@@ -1,148 +0,0 @@
----
-name: persistent-memory
-description: Persistent memory management for Claude sessions using the brain MCP tool. Use when starting a work session, making architectural decisions, learning from mistakes, ending a session, or when user says "remember this", "what do I know about", "recall", "brain", or "session summary". Also use when searching code symbols, files, or dependencies with search_code.
-license: MIT
-metadata:
-  author: claude-brain
-  version: 1.0.0
-  mcp-server: claude-brain
-  category: productivity
-  tags: [memory, persistence, decisions, context, code-intelligence]
----
-
-# Persistent Memory
-
-Manage persistent memory across Claude sessions using the `brain` and `search_code` MCP tools. Memory persists between conversations — decisions, lessons, and context survive session boundaries.
-
-## Critical Rules
-
-- The `brain` tool auto-classifies intent. Most of the time, just pass a natural language message — don't force an action unless you have a reason.
-- Do NOT store file paths, "read file X" events, or progress like "ran tests" — these are too granular and captured automatically by hooks.
-- DO store the WHY — reasoning behind decisions, user preferences, lessons learned from debugging.
-- Use the `project` parameter to scope memories to the right project. If omitted, it's auto-detected from the message.
-
-## Session Workflow
-
-### Step 1: Session Start — Recall Context
-
-At the beginning of significant work, recall what you know:
-
-```
-brain("What do I know about this project?")
-```
-
-This returns past decisions, preferences, patterns, and lessons. Use it to avoid re-asking questions the user already answered in previous sessions.
-
-Expected output: A summary of stored memories with relevance scores.
-
-### Step 2: During Work — Store Decisions and Lessons
-
-Store when you encounter something worth remembering:
-
-**Decisions:**
-```
-brain("Decided to use JWT over sessions because the app is stateless")
-```
-
-**Mistakes and fixes:**
-```
-brain("The bug was caused by missing CORS credentials — fixed with credentials: include")
-```
-
-**User preferences:**
-```
-brain("User prefers explicit error messages over generic 500s")
-```
-
-**Architecture changes:**
-```
-brain("Changed database from MySQL to Postgres for better JSON support")
-```
-
-### Step 3: Session End — Summarize
-
-Before finishing significant work, store a 2-3 sentence summary:
-
-```
-brain("Session summary: Built auth flow for expense tracker. Chose JWT for stateless architecture. Hit CORS issue on /api/login, fixed with credentials: include.")
-```
-
-## Using search_code
-
-The `search_code` tool searches indexed code — faster than grep for large projects.
-
-**Search symbols (functions, classes, types):**
-```
-search_code({ query: "handleAuth", project: "my-app" })
-```
-
-**Search files by name:**
-```
-search_code({ query: "config", project: "my-app", type: "files" })
-```
-
-**Show dependencies of a file:**
-```
-search_code({ query: "deps", project: "my-app", type: "dependencies", file_path: "src/auth.ts" })
-```
-
-If search returns no results, the project may need indexing. Run `claude-brain reindex` first.
-
-## Advanced Patterns
-
-### Updating Past Memories
-When a previous decision changes:
-```
-brain({ message: "Changed my mind — use Postgres instead of MySQL", action: "update" })
-```
-
-### Getting Full Details
-Search returns compact summaries. For the full stored content:
-```
-brain("details 42")
-```
-where 42 is the memory ID from a previous search result.
-
-### Deleting Outdated Memories
-```
-brain({ message: "delete memory about MySQL choice", action: "delete" })
-```
-
-### Scoping to Projects
-Always pass the project name for multi-project work:
-```
-brain({ message: "Chose Tailwind for styling", project: "expense-tracker" })
-```
-
-## What to Store vs. Skip
-
-### Store These
-- Architectural decisions and their reasoning
-- User preferences for tools, style, workflow
-- Solutions to hard debugging problems
-- Patterns confirmed across multiple sessions
-- Key file paths and project structure insights
-
-### Skip These
-- File read/write events (captured by hooks)
-- "Ran tests" / "built successfully" (too granular)
-- Anything already in CLAUDE.md or the codebase
-- Speculative conclusions from reading a single file
-
-## Troubleshooting
-
-### brain tool returns "no relevant memories"
-**Cause:** No memories stored yet, or query doesn't match stored content.
-**Solution:** Try broader phrasing. Use `brain("list all memories for project X")` to see what's stored.
-
-### search_code returns empty results
-**Cause:** Project not indexed.
-**Solution:** Run `claude-brain reindex` in terminal, then retry.
-
-### Memories scoped to wrong project
-**Cause:** Project name not specified or auto-detected incorrectly.
-**Solution:** Always pass `project` parameter explicitly for multi-project work.
-
-### brain tool seems slow
-**Cause:** Large memory database or complex semantic search.
-**Solution:** Use more specific queries. Scope to a project to narrow search space.

package/skills/persistent-memory/references/tool-reference.md

@@ -1,90 +0,0 @@
-# Tool Reference
-
-Complete parameter reference for the brain and search_code MCP tools.
-
-## brain
-
-Your persistent memory. Tell it decisions, ask it questions, or update/delete past notes.
-
-### Parameters
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `message` | string | Yes | What you are doing, decided, learned, or need. Natural language. |
-| `project` | string | No | Project name to scope memories (e.g., "my-app"). Auto-detected if omitted. |
-| `action` | enum | No | Force action: `auto`, `store`, `recall`, `update`, `delete`. Default: `auto`. |
-
-### Intent Classification
-
-When `action` is `auto` (default), the tool classifies your message into one of these intents:
-
-- **session_start** — "What do I know about X?" / beginning of session
-- **decision_made** — "Decided to use X because Y"
-- **store_this** — "Remember that..." / storing information
-- **pattern_found** — "I noticed a pattern where..."
-- **mistake_learned** — "The bug was X, fixed by Y"
-- **question** — "What was the reason for X?"
-- **context_needed** — Requesting stored context
-- **update_memory** — Changing a previous memory
-- **delete_memory** — Removing a memory
-- **detail_request** — "details {ID}" for full content
-- **list_all** — "list all memories" / "show everything"
-- **timeline** — "show history" / "what happened when"
-- **comparison** — "compare X vs Y decisions"
-- **exploration** — Open-ended exploration of stored knowledge
-- **progress_update** — "Completed X, next steps Y"
-
-### Response Format
-
-```json
-{
-  "action": "stored | retrieved | updated | deleted | none",
-  "summary": "Brief description of what happened",
-  "content": "Full response with details",
-  "relevantItems": 5
-}
-```
-
-## search_code
-
-Search indexed code for symbols, files, or dependencies. Faster than grep for indexed projects.
-
-### Parameters
-
-| Parameter | Type | Required | Default | Description |
-|-----------|------|----------|---------|-------------|
-| `query` | string | Yes | — | Symbol name, file name, or search term |
-| `project` | string | Yes | — | Project name (usually directory name) |
-| `type` | enum | No | `symbols` | `symbols`, `files`, or `dependencies` |
-| `file_path` | string | No* | — | Required when type is `dependencies` |
-| `limit` | number | No | 20 | Max results (1-100) |
-
-### Search Types
-
-**symbols** (default): Search functions, classes, types, interfaces by name.
-```
-search_code({ query: "UserService", project: "my-app" })
-```
-
-**files**: Search for files by name pattern.
-```
-search_code({ query: "middleware", project: "my-app", type: "files" })
-```
-
-**dependencies**: Show imports and imported-by for a specific file.
-```
-search_code({ query: "deps", project: "my-app", type: "dependencies", file_path: "src/auth/service.ts" })
-```
-
-### Supported File Types
-
-`.ts .tsx .js .jsx .mjs .cjs .py .go .rs .vue .html .css .json .yaml .yml`
-
-### Indexing
-
-If search returns no results, the project needs indexing:
-```bash
-claude-brain reindex
-```
-
-This parses the codebase using tree-sitter and stores symbols in SQLite for fast lookup.