| name | ct-memory |
| version | 1.0.0 |
| description | Brain memory protocol with progressive disclosure for anti-hallucination and context recall |
| triggers | ["memory","brain","recall","remember","anti-hallucination"] |
ct-memory -- Brain Memory Protocol
Purpose
Ensures LLM agents never start conversations with amnesia. Provides structured memory access through CLEO's brain system using progressive disclosure.
Tier 0: Session Start (ALWAYS run on first interaction)
Use CLI (cleo) for all memory operations.
- The memory bridge (.cleo/memory-bridge.md) is already loaded via CLEO-INJECTION.md @-reference
- If the bridge content feels stale (>2 hours old), refresh:
cleo memory find "session task decision" --limit 10
- Check for anti-patterns to avoid:
cleo memory find "mistake error avoid warning" --limit 5
- If results are relevant, fetch details:
cleo memory fetch O-xxx O-yyy
Tier 1: During Work (run when topic-relevant)
Before Making Decisions
cleo memory find "decision ADR architecture" --limit 5- Check if a similar decision was already made
Before Repeating Work
cleo memory find "{current-topic}" --limit 10- Avoid re-doing work that's already been completed
After Completing Significant Work
cleo memory observe "Completed X using approach Y. Key learning: Z" --title "Work completion"
Anti-Hallucination Protocol
Before stating facts about the codebase or project:
- Search brain:
cleo memory find "{claim-topic}" --limit 5
- If results exist, verify your claim matches stored knowledge
- If no results, state your uncertainty clearly
Tier 2: Deep Recall (run when specifically needed)
Full Timeline
cleo memory timeline O-xxx --before 5 --after 5- Understand chronological context around a specific observation
Cross-Project Knowledge (via NEXUS)
cleo nexus search "pattern" --scope global- Search across all CLEO-managed projects
Token Budget Guidelines
| Operation | ~Tokens | When |
|---|
| memory-bridge.md (auto-loaded) | 200-400 | Always (free) |
cleo memory find | 50/hit | Discovery |
cleo memory fetch | 500/entry | Details |
cleo memory timeline | 200-500 | Context |
Stay within LAFS MVI budget: start minimal, escalate only when needed.
