claude_memory 0.13.0 → 0.13.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/.claude-plugin/marketplace.json +1 -1
- data/.claude-plugin/plugin.json +1 -1
- data/CHANGELOG.md +25 -0
- data/docs/improvements.md +83 -0
- data/lib/claude_memory/commands/checks/fts_rank_check.rb +60 -0
- data/lib/claude_memory/commands/doctor_command.rb +2 -0
- data/lib/claude_memory/commands/index_command.rb +22 -4
- data/lib/claude_memory/commands/setup_vectors_command.rb +9 -3
- data/lib/claude_memory/distill/null_distiller.rb +24 -2
- data/lib/claude_memory/hook/context_injector.rb +35 -10
- data/lib/claude_memory/index/lexical_fts.rb +47 -23
- data/lib/claude_memory/index/vector_index.rb +27 -0
- data/lib/claude_memory/mcp/server.rb +33 -1
- data/lib/claude_memory/observe/reflector.rb +32 -16
- data/lib/claude_memory/observe/token_overlap_matcher.rb +55 -0
- data/lib/claude_memory/sweep/maintenance.rb +22 -0
- data/lib/claude_memory/sweep/sweeper.rb +1 -0
- data/lib/claude_memory/version.rb +1 -1
- data/lib/claude_memory.rb +2 -0
- metadata +3 -25
- data/.claude/CLAUDE.md +0 -4
- data/.claude/memory.sqlite3 +0 -0
- data/.claude/output-styles/memory-aware.md +0 -1
- data/.claude/rules/claude_memory.generated.md +0 -87
- data/.claude/settings.json +0 -113
- data/.claude/settings.local.json +0 -59
- data/.claude/skills/check-memory/DEPRECATED.md +0 -29
- data/.claude/skills/check-memory/SKILL.md +0 -87
- data/.claude/skills/dashboard/SKILL.md +0 -42
- data/.claude/skills/debug-memory +0 -1
- data/.claude/skills/improve/SKILL.md +0 -631
- data/.claude/skills/improve/feature-patterns.md +0 -1221
- data/.claude/skills/memory-first-workflow +0 -1
- data/.claude/skills/quality-update/SKILL.md +0 -229
- data/.claude/skills/quality-update/implementation-guide.md +0 -346
- data/.claude/skills/release/SKILL.md +0 -206
- data/.claude/skills/review-commit/SKILL.md +0 -199
- data/.claude/skills/review-for-quality/SKILL.md +0 -154
- data/.claude/skills/review-for-quality/expert-checklists.md +0 -79
- data/.claude/skills/setup-memory +0 -1
- data/.claude/skills/study-repo/SKILL.md +0 -322
- data/.claude/skills/study-repo/analysis-template.md +0 -323
- data/.claude/skills/study-repo/focus-examples.md +0 -327
- data/.claude/skills/upgrade-dependencies/SKILL.md +0 -154
|
@@ -1,87 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: check-memory
|
|
3
|
-
description: Explicitly check memory system before answering or exploring
|
|
4
|
-
disable-model-invocation: true
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# Check Memory First
|
|
8
|
-
|
|
9
|
-
When invoked with `/check-memory <topic>`, this skill forces a memory-first workflow.
|
|
10
|
-
|
|
11
|
-
## Task
|
|
12
|
-
|
|
13
|
-
**IMPORTANT: You MUST check memory BEFORE reading any files or running any code searches.**
|
|
14
|
-
|
|
15
|
-
The user is asking about: $ARGUMENTS
|
|
16
|
-
|
|
17
|
-
## Step-by-Step Workflow
|
|
18
|
-
|
|
19
|
-
### 0. Verify Memory Health
|
|
20
|
-
|
|
21
|
-
Before querying, confirm the memory system is operational:
|
|
22
|
-
|
|
23
|
-
```
|
|
24
|
-
memory.check_setup
|
|
25
|
-
```
|
|
26
|
-
|
|
27
|
-
If status is not "healthy", inform the user and suggest running `claude-memory doctor` for details.
|
|
28
|
-
|
|
29
|
-
### 1. Query Memory (REQUIRED FIRST STEP)
|
|
30
|
-
|
|
31
|
-
Run multiple memory queries to find existing knowledge:
|
|
32
|
-
|
|
33
|
-
```
|
|
34
|
-
memory.recall "$ARGUMENTS"
|
|
35
|
-
```
|
|
36
|
-
|
|
37
|
-
Also try specialized shortcuts:
|
|
38
|
-
- `memory.decisions` (if implementing a feature)
|
|
39
|
-
- `memory.architecture` (if working with frameworks)
|
|
40
|
-
- `memory.conventions` (if writing code)
|
|
41
|
-
- `memory.conflicts` (if encountering contradictions)
|
|
42
|
-
|
|
43
|
-
### 2. Analyze Results
|
|
44
|
-
|
|
45
|
-
Review what memory returns:
|
|
46
|
-
- **If sufficient**: Answer using recalled facts with citations
|
|
47
|
-
- **If partial**: Note what's known and what needs investigation
|
|
48
|
-
- **If empty**: Memory has no knowledge on this topic yet
|
|
49
|
-
|
|
50
|
-
### 3. Explore Code (ONLY IF NEEDED)
|
|
51
|
-
|
|
52
|
-
If memory doesn't have enough information:
|
|
53
|
-
- Use Read/Grep/Glob to explore the codebase
|
|
54
|
-
- Clearly distinguish between:
|
|
55
|
-
- **Recalled knowledge** (from memory)
|
|
56
|
-
- **Discovered information** (from code exploration)
|
|
57
|
-
|
|
58
|
-
### 4. Provide Complete Answer
|
|
59
|
-
|
|
60
|
-
Combine:
|
|
61
|
-
- Facts from memory (with fact IDs if relevant)
|
|
62
|
-
- New information from code exploration (if any)
|
|
63
|
-
- Clear indication of sources
|
|
64
|
-
|
|
65
|
-
## Example Response Format
|
|
66
|
-
|
|
67
|
-
```
|
|
68
|
-
Based on memory:
|
|
69
|
-
- [Fact from memory with context]
|
|
70
|
-
|
|
71
|
-
From code exploration:
|
|
72
|
-
- [New findings from reading files]
|
|
73
|
-
|
|
74
|
-
Answer: [Complete response combining both sources]
|
|
75
|
-
```
|
|
76
|
-
|
|
77
|
-
## Why This Matters
|
|
78
|
-
|
|
79
|
-
Memory contains distilled knowledge from previous sessions. Checking it first:
|
|
80
|
-
- Saves time (no need to re-explore known areas)
|
|
81
|
-
- Provides context (decisions, patterns, conventions)
|
|
82
|
-
- Avoids mistakes (previous lessons learned)
|
|
83
|
-
- Reduces token usage (recalled facts are concise)
|
|
84
|
-
|
|
85
|
-
## Remember
|
|
86
|
-
|
|
87
|
-
**ALWAYS start with memory queries. NEVER skip this step.**
|
|
@@ -1,42 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: dashboard
|
|
3
|
-
description: Launch a local web dashboard for ClaudeMemory debugging and observability
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Dashboard
|
|
7
|
-
|
|
8
|
-
Launch the ClaudeMemory debugging dashboard to visualize memory system health, activity, and efficacy.
|
|
9
|
-
|
|
10
|
-
## Task
|
|
11
|
-
|
|
12
|
-
Start the dashboard web server so the user can inspect what's happening behind the scenes.
|
|
13
|
-
|
|
14
|
-
## Steps
|
|
15
|
-
|
|
16
|
-
1. Run the dashboard command:
|
|
17
|
-
|
|
18
|
-
```bash
|
|
19
|
-
claude-memory dashboard
|
|
20
|
-
```
|
|
21
|
-
|
|
22
|
-
This starts a local web server (default port 3377) and opens it in the browser.
|
|
23
|
-
|
|
24
|
-
## What the Dashboard Shows
|
|
25
|
-
|
|
26
|
-
- **Health Status**: Database health, hook configuration, vector index status
|
|
27
|
-
- **Overview**: Fact/entity/content counts, top predicates, entity type distribution, 30-day activity timeline
|
|
28
|
-
- **Activity**: Live event log of hook executions (ingest, context, sweep), memory recalls, and store extractions with timing and details
|
|
29
|
-
- **Facts**: Searchable fact explorer with status filtering, predicate/object search
|
|
30
|
-
- **Efficacy**: Recall hit rate, total results served, average results per query, top queries by result count
|
|
31
|
-
|
|
32
|
-
## Options
|
|
33
|
-
|
|
34
|
-
- `--port PORT` - Use a different port (default: 3377)
|
|
35
|
-
- `--no-open` - Don't auto-open the browser
|
|
36
|
-
|
|
37
|
-
## Notes
|
|
38
|
-
|
|
39
|
-
- Dashboard auto-refreshes every 30 seconds
|
|
40
|
-
- Activity events are recorded by hooks and MCP tools into the `activity_events` table
|
|
41
|
-
- The dashboard reads from both global and project databases
|
|
42
|
-
- Press Ctrl+C to stop the server
|
data/.claude/skills/debug-memory
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
../../skills/debug-memory
|