| name | memory-manager |
| description | Persistent memory layer across sessions. Use to recall prior context at the start of work, to store checkpoints at phase boundaries, and to answer "what did we decide / do before" questions. Backed by the agentmemory server (local SQLite + vector embeddings) on port 3111, with an MCP-only fallback. Every phase skill calls this to survive /clear and compaction boundaries. |
Memory Manager (persistent layer)
Adapted from rohitg00/agentmemory. Gives the SDLC recall across sessions so work resumes
instead of restarting.
Architecture
- Server — local agentmemory server on
http://127.0.0.1:3111 (started by the
SessionStart hook via scripts/memory-up.*). Uses local SQLite + vector embeddings
(@xenova/transformers, no external API).
- Fallback — if the native server/
iii-engine cannot run (esp. Windows), use the MCP
server npx -y @agentmemory/mcp. Recall quality is lower but the workflow still functions.
- Config —
AGENTMEMORY_INJECT_CONTEXT=true and AGENTMEMORY_AUTO_COMPRESS=true are
set in settings.json (both ship OFF by default upstream — we turn them ON).
Operations
- recall(project, query?) — GET
/recall. Do this at session start and before big decisions.
- store(record) — POST
/store. Do this at every phase boundary with keys in English:
{project, kind, phase, artifact, decision, next, note}. Values may be Ukrainian.
- checkpoint — a
store with kind="checkpoint" and a "RESUME HERE" note.
When to call
- SessionStart (hook does it) — recall.
- End of each phase — store checkpoint.
- Before
/clear or on PreCompact (hook does it) — store checkpoint.
- When the user asks what was decided/done previously — recall + answer.
Degradation
If memory is unavailable, say so explicitly and continue using .sdlc/state.json + the
phase artifacts on disk as the fallback source of truth. Never block the workflow on memory.
Примітка (UK)
Шар постійної пам'яті між сесіями: локальний сервер agentmemory (SQLite + векторні
ембединги) на порту 3111, з MCP як резервом. Ключі записів — англійською, значення можуть
бути українською. Якщо памʼять недоступна — працюємо за файлами на диску й попереджаємо.
