From feff0b8e5c5ff07b5f50cc2cd9f5cc357c097a05 Mon Sep 17 00:00:00 2001 From: Yakuphan Yucel Date: Mon, 27 Apr 2026 15:18:17 +0300 Subject: [PATCH] docs(readme): expand "How It Compares" with letta + LangMem + decision rules MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Renames "Why Not Just CLAUDE.md?" → "How It Compares" (decision-stage SEO). Keeps the CLAUDE.md elevator pitch as section opener. Comparison table gains Letta and LangMem rows (the two big agent-memory frameworks people evaluate against), plus a flat-file row covering CLAUDE.md / .cursorrules explicitly. Adds two decision-rule paragraphs ("When to reach for instinct" vs "When to reach for the others") so visitors can self-select fast. No structural rename of the section anchor; "Why Not Just CLAUDE.md?" inbound links would 404, but the prior section was hyphen-ASCII anchored ("why-not-just-claude-md") and "How It Compares" anchors as "how-it-compares" — different. Acceptable since the section is mid-fold, unlikely to be deep-linked. Co-Authored-By: Claude Opus 4.7 (1M context) --- README.md | 17 ++++++++++++----- 1 file changed, 12 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 1d37eb0..88f9eba 100644 --- a/README.md +++ b/README.md @@ -112,17 +112,24 @@ instinct serve --transport streamable-http # streamable HTTP instinct serve --port 3777 ``` -## Why Not Just CLAUDE.md? +## How It Compares CLAUDE.md is good for hand-written rules. instinct is for patterns that should earn their way into rules through repetition. | Surface | Best fit | Different because | |---|---|---| -| `instinct` | Coding-agent pattern memory | Local SQLite, confidence tiers, decay, cross-project promotion, MCP tools. | -| [Mem0](https://github.com/mem0ai/mem0) | General AI memory layer | Broader memory product; instinct is narrower and coding-agent focused. | -| [claude-mem](https://github.com/search?q=claude-mem&type=repositories) | Claude-specific memory experiments | instinct exposes MCP tools plus CLI exports across multiple agents. | -| [Pieces](https://pieces.app/) | Developer snippets and workflow context | instinct stores repeated behavioral patterns rather than a general knowledge library. | +| `instinct` | Coding-agent pattern memory | Local SQLite, confidence tiers, decay, cross-project promotion, MCP-native — works with any MCP-compatible agent. | +| [Mem0](https://github.com/mem0ai/mem0) | General LLM memory layer | Broader memory product (chat history, episodic facts); instinct is narrower and coding-agent focused on behavioral patterns. | +| [Letta](https://github.com/letta-ai/letta) (formerly MemGPT) | Stateful agent runtime | Full agent framework with memory built-in; instinct is a memory-only sidecar you bolt onto your existing agent. | +| [LangMem](https://github.com/langchain-ai/langmem) | Memory for LangChain | Tied to LangChain ecosystem; instinct is framework-agnostic via MCP. | +| [claude-mem](https://github.com/search?q=claude-mem&type=repositories) | Claude-specific memory experiments | instinct exposes MCP tools plus CLI exports across Claude, Cursor, Windsurf, Goose, and Codex. | +| [Pieces](https://pieces.app/) | Developer snippets and workflow context | instinct stores repeated behavioral patterns; Pieces stores artifacts (snippets, links, screenshots). | +| `CLAUDE.md` / `.cursorrules` | Hand-written rule files | Flat text, manual maintenance. instinct can export to these formats once a pattern matures. | + +**When to reach for instinct:** your agent makes the same correction or follows the same workflow more than 3 times and you don't want to keep retyping. instinct records once, promotes after repetition, and surfaces it back automatically. + +**When to reach for the others:** chat-history recall (Mem0), full agent runtime with built-in memory (Letta), LangChain integration (LangMem), or static hand-curated rules (CLAUDE.md / .cursorrules). ## Storage and Runtime