diff --git a/.claude/CLAUDE.md b/.claude/CLAUDE.md
index 26182b8..859b8ee 100644
--- a/.claude/CLAUDE.md
+++ b/.claude/CLAUDE.md
@@ -10,8 +10,8 @@ This project uses [Soul Protocol](https://github.com/qbtrix/soul-protocol) for p
 3. Call `soul_list` to see all loaded souls (multi-soul support via `SOUL_DIR`)
 
 **During work:**
-- `soul_observe` after key decisions, completed tasks, or important conversations
-- `soul_remember` for facts that should persist across sessions
+- `soul_observe` after key decisions, completed tasks, or important conversations — runs the full pipeline (extracts facts, reconciles against existing entries, updates self-model). Prefer this whenever a fact comes out of a real user/agent turn, since it deduplicates as it stores.
+- `soul_remember` only for blunt writes you want to force through: short episodic events, or cases where you've already decided dedup is wrong (e.g. a unique timestamped log line). It appends without `reconcile_fact`, so repeated calls with similar text will accumulate near-duplicates. The CLI sibling `soul remember` is on a deprecation path toward `soul note` (#231 phase 2); the MCP tool will follow once the dedup-aware variant is exposed there.
 - `soul_feel` to update emotional state after significant events
 - `soul_prompt` to generate a system prompt for LLM injection