2.5 KiB
id, title, status, date, updated, authors, tags
| id | title | status | date | updated | authors | tags | |||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ADR-0001 | ruflo-rag-memory plugin contract — pinning, claude-memories reserved-namespace consumer, smoke as contract | Accepted | 2026-05-04 | 2026-05-09 |
|
|
Context
ruflo-rag-memory (v0.2.0) — simple memory + HNSW semantic retrieval. 1 agent (memory-specialist), 2 skills (memory-bridge, memory-search), 2 commands (/recall, /ruflo-memory).
This plugin is the canonical consumer of the claude-memories reserved namespace (per ruflo-agentdb ADR-0001 §"Namespace convention"). Claude Code's SessionStart hook auto-imports ~/.claude/projects/*/memory/*.md into AgentDB via memory_import_claude → claude-memories. This plugin's memory-bridge skill exposes that bridge to users.
Decision
- Add this ADR (Proposed).
- README augment: Compatibility (pin v3.6); Namespace coordination block — explicit consumer-of-claude-memories; Verification + Architecture Decisions sections.
- Plugin metadata stays at
0.2.0(already at the cadence). Keywords addmcp,claude-memories,bridged-memory. scripts/smoke.sh— 10 structural checks: version + keywords; both skills + agent + 2 commands with valid frontmatter; v3.6 pin; namespace coordination cross-reference;claude-memoriesreserved-namespace consumer documented;memory_import_claude+memory_search_unifiedreferenced; ADR Proposed; no wildcard tools.
Consequences
Positive: plugin joins the cadence. The "consumer of claude-memories" relationship is now contractually documented.
Negative: none material.
Verification
bash plugins/ruflo-rag-memory/scripts/smoke.sh
# Expected: "10 passed, 0 failed"
Related
plugins/ruflo-agentdb/docs/adrs/0001-agentdb-optimization.md— owns theclaude-memoriesreserved namespace and the auto-import bridgeplugins/ruflo-ruvector/docs/adrs/0001-pin-ruvector-0.2.25.md— sibling substrate plugin
Implementation status
Plugin version v0.2.0 shipped and listed in marketplace.json. Source exists at plugins/ruflo-rag-memory/. Contract elements implemented: canonical consumer of claude-memories reserved namespace documented; memory_import_claude + memory_bridge_status + memory_search_unified MCP tools covered; auto-import via SessionStart hook cross-referenced; smoke-as-contract gate defined in scripts/smoke.sh.