From c2e5c4925b2560c5f6a97dacf0bf6506a71f90aa Mon Sep 17 00:00:00 2001 From: prakashUXtech Date: Sat, 23 May 2026 11:42:27 +0530 Subject: [PATCH] docs(claude.md): steer Claude toward soul_observe for facts (post-#231) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Update the agent-facing memory guide so the MCP recommendation matches the post-#231 reality: - soul_observe is the dedup-aware path: it runs the full pipeline (extraction + reconcile_fact + self-model update), so facts pulled out of real user/agent turns collapse onto existing entries rather than appending duplicates. - soul_remember is now scoped to blunt forced writes — short episodic events, or cases where dedup is explicitly wrong. The bullet calls out that the CLI sibling 'soul remember' is on a deprecation path toward 'soul note' (#231 phase 2 / PR #236) and that the dedup-aware MCP variant will follow once it ships. Pure docs change. No runtime behavior or test impact. Refs #231, #251. --- .claude/CLAUDE.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) 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