Skip to content

docs(readme): expand 'How It Compares' with letta + LangMem + decision rules#40

Merged
yakuphanycl merged 1 commit into
mainfrom
chore/readme-comparison-expand
Apr 27, 2026
Merged

docs(readme): expand 'How It Compares' with letta + LangMem + decision rules#40
yakuphanycl merged 1 commit into
mainfrom
chore/readme-comparison-expand

Conversation

@yakuphanycl
Copy link
Copy Markdown
Contributor

Summary

Decision-stage SEO + comparative-shopping clarity. Renames the section, adds the two big competitors (Letta, LangMem), and adds two short "when to reach for X" decision rules so visitors self-select.

Changes

  • Section renamed: "Why Not Just CLAUDE.md?" → "How It Compares"
  • Comparison table grows from 4 rows → 7 rows: + Letta, + LangMem, + flat-file rules (CLAUDE.md / .cursorrules)
  • Sharper one-liners: each row's "Different because" column states the actual differentiator
  • Two new paragraphs after the table: "When to reach for instinct" / "When to reach for the others"

Test plan

  • Markdown renders cleanly (table aligns, links resolve)
  • No anchor-link callers in this repo break (grepped "why-not-just-claude-md" — no matches)
  • External inbound links to old anchor: low risk; section is mid-fold and rarely deep-linked

Note

Section anchor changes ("why-not-just-claude-md" → "how-it-compares"). Acceptable per commit message reasoning — mid-fold section, not commonly deep-linked.

🤖 Generated with Claude Code

…n rules

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) <noreply@anthropic.com>
@yakuphanycl yakuphanycl merged commit 2aa3102 into main Apr 27, 2026
11 checks passed
@yakuphanycl yakuphanycl deleted the chore/readme-comparison-expand branch April 27, 2026 12:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant