diff --git a/CLAUDE.md b/CLAUDE.md
index 0c2d556..9759ccd 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -133,7 +133,7 @@ Cognitive Memory provides persistent, human-readable markdown-based memory acros
 3. Recall relevant memories before any significant task:
 
 ```bash
-python ~/.claude/skills/cognitive-memory/client.py recall "project-name technology problem-type"
+claude-memory recall "project-name technology problem-type"
 ```
 
 ### REQUIRED: Automatic Storage Triggers
@@ -142,7 +142,7 @@ Store memories on ANY of these events:
 | Trigger | What to Store |
 |---------|---------------|
 | **Bug fix** | Problem + solution with SOLVES relationship |
-| **Git commit** | Summary of what was fixed/added and why |
+| **Git commit** | **MANDATORY** — store memory immediately after every successful commit with full context (reasoning, trade-offs, debugging steps), not just the commit message. Use `--episode` flag. Never skip. |
 | **Architecture decision** | Choice made + rationale + alternatives |
 | **Pattern discovered** | Reusable approach with context |
 | **Configuration that worked** | Setup details that solved an issue |
@@ -154,25 +154,18 @@ Store memories on ANY of these events:
 All commands support `--help`. Key patterns:
 
 ```bash
-CM=~/.claude/skills/cognitive-memory/client.py
-
-# Core workflow: store (--episode auto-logs), recall (--semantic for deeper matching)
-python $CM store --type solution --title "Fixed X" --content "..." --tags "t1,t2" --episode
-python $CM recall "redis timeout" --semantic
+# Core workflow
+claude-memory store --type solution --title "Fixed X" --content "..." --tags "t1,t2" --episode
+claude-memory recall "redis timeout" --semantic
 
 # Relationships and search
-python $CM relate <from_id> <to_id> SOLVES
-python $CM search --types "solution" --tags "python"
+claude-memory relate <from_id> <to_id> SOLVES
+claude-memory search --types "solution" --tags "python"
 
-# Procedures with structured steps
-python $CM procedure --title "Deploy" --content "..." --steps "test,build,deploy"
-
-# Reflection and tag analysis
-python $CM reflect --since 2026-01-01
-python $CM tags suggest <memory_id>
-
-# Maintenance: decay, core, embed, reindex
-python $CM decay && python $CM core && python $CM embed
+# Procedures, reflection, maintenance
+claude-memory procedure --title "Deploy" --content "..." --steps "test,build,deploy"
+claude-memory reflect --since 2026-01-01
+claude-memory decay && claude-memory core && claude-memory embed
 ```
 
 ### Memory Types