oxbshw Agent Memory Curator
When to use
- End of a working session
- After resolving an incident worth remembering
- When
MEMORY.mdhas grown stale or contradictory
When NOT to use
- During a session (don't write memory mid-flight from low-confidence signals)
- For raw transcripts (those stay in
logs/)
Inputs
| Name | Type | Required | Notes |
|---|---|---|---|
since |
date | no | default: last curation time |
categories |
list | no | restrict to e.g. [user, project, decision] |
Workflow
- Read new episodic logs in
logs/episodic/sincesince - Distill each notable event into a one-line dated entry
- Categorize into: user / project / decision / feedback / open question
- Reconcile: if a new entry contradicts an existing one, update the existing one rather than appending; move the old fact to "Outdated"
- Apply rules from
references/memory-distillation-rules.md - Write to
MEMORY.md(index) andmemory/semantic/<topic>.md(details) - Verify no PII / secrets leaked into memory
- Report summary of additions / updates / deletions
References
references/memory-distillation-rules.md
Success criteria
- Every new entry is dated
- No duplicate entries (search before adding)
- No PII / secret values
- Outdated entries moved, not deleted in-place
Failure modes
- Conflicting evidence → mark as "Open question" rather than guessing
- Source untrusted (e.g., from MCP/web fetch) → require human confirm before promotion