Skip to content

docs(claude.md): steer Claude toward soul_observe for facts (post-#231) #252

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
prakashUXtech merged 1 commit into from
May 23, 2026
Merged

docs(claude.md): steer Claude toward soul_observe for facts (post-#231) #252

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions .claude/CLAUDE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
Loading