memory-manager

Memory Manager

Mission

Build compounding capability by turning execution traces into reusable, evidence-linked memory, with retrieval centered on prior experience rather than only current working state.

Load References

Load these files before writing or promoting records:

1. references/memory-layout.md
2. references/memory-templates.md
3. references/sqlite-schema.sql

Memory Types

Manage these layers:

1. working
   • run-scoped continuity state
   • resume after compaction, interruption, or long waits
2. episode
   • concrete run case records
   • useful for similar errors, repeated attempts, and local history
3. procedure
   • highest-priority execution memory
   • default retrieval layer before acting
4. insight
   • cross-task abstraction, tradeoffs, boundaries, and contradiction handling
5. persona
   • behavior config only

Working Memory Contract

working must include:

1. goal
2. stage
3. hypothesis
4. last_action
5. last_observation
6. next_step
7. blockers
8. evidence_refs
9. active_action_ids
10. todo_active
11. todo_done
12. todo_blocked

Todo granularity should be task-level (small stages/subtasks), not command-level.

Experience-First Retrieval Policy

Prior experience retrieval is the default. working is important for continuity, but it is not the only retrieval path and should not crowd out reusable experience.

Mandatory retrieval triggers:

1. every new user turn
2. every execution batch before acting
3. every replan
4. every significant failure or new error signature
5. every high-resource or irreversible action
6. every long-action resume or post-poll decision
7. before final answer or report handoff
8. when modifying memory-manager or another Memory-related skill/instruction
9. when compaction markers such as Compact, 压缩, or Summary appear

Default retrieval order:

1. procedure
   • mandatory before every execution batch
2. episode
   • mandatory when a similar failure, repeated attempt, or same task type is present
3. insight
   • mandatory during planning, tradeoff analysis, contradiction handling, or final answer shaping
4. working
   • mandatory for resume, compaction recovery, long-action reconciliation, and final handoff