ai-memory
Auto-generated from project docs
North Star
Booklet Status
| Booklet | Status | Branch | Appetite | Deadline | Notes |
|---|---|---|---|---|---|
| B0 | COMPLETE | N/A | 1hr | 2026-03-30 | Inherited. MEMORY.md cleanup, dead systems removed |
| B1 | COMPLETE | N/A | 1 day | 2026-03-30 | Inherited. Mem0 + pgvector + MCP + 31 memories |
| B2 | COMPLETE | N/A | 1.5hr | 2026-04-07 | 28→4 feedback files, 9 dead files killed (83→59), MEMORY.md 131→96, enforcement hook, Mem0 wired into session-manager.sh, mem0-cli.sh |
| B3 | COMPLETE | — | 45min | 2026-04-07 | Min Min verify-exec.ts wired (recall+remember), HAA run-with-mem0.sh (pre-fetch+post-store), claw_memory migrated (32→39), cross-agent test passed |
| B4 | COMPLETE | — | 20min | 2026-04-07 | memory-audit.sh, cron Monday 8UTC, TTL warning, mem0-cli list/delete |
| B5 | CONFIRMED-WORKING | — | 4hr | 2026-04-12 | v2: MCP memory server + Postgres schema + migration + auto-bootstrap. 102 memories, Grade A. All 6 MCP tools native-callable from Claude Code (verified 2026-04-13). INCIDENT-049 resolved. |
Recent Decisions
| Date | Decision | Rationale |
|---|---|---|
| ------ | ---------- | ----------- |
| 2026-04-12 | v2 rescope: database-backed MCP server | INCIDENT-044 + RESEARCH-224. File-based index fails repeatedly. Every mature system uses DB as source of truth. |
| 2026-04-12 | Custom pgvector over keeping Mem0 | Mem0 summarizes on write (lossy). Need raw storage + hierarchical schema. Same pgvector infra. |
| 2026-04-12 | Store raw, retrieve smart (Mem-Palace pattern) | Never summarize at ingestion. Structural filtering + hybrid search on read. 34% retrieval boost. |
| 2026-04-07 | Rescoped from mem0-memory-layer to ai-memory | Broader scope: unified memory, not just Mem0 install. RESEARCH-206 gap analysis. |
| 2026-04-07 | Two layers, not five | CLAUDE.md/MEMORY.md for bootstrap + Mem0 for shared knowledge. Everything else is noise. |
| 2026-04-07 | Enforcement via hooks, not discipline | INCIDENT-024 proved agent discipline fails. Hooks are the only reliable enforcement. |
| 2026-03-30 | Mem0 over custom build | 48K stars, Apache 2.0, native pgvector. Why reinvent? |
| 2026-03-30 | HAA read-only initially | Autonomous agent writing bad memories propagates to all agents. Validate first. |
| 2026-03-30 | Gemini embeddings over local | Free tier covers volume. Saves RAM vs Ollama. |
Source: /root/projects/ai-memory/