ct-memory

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.

1. The memory bridge (.cleo/memory-bridge.md) is already loaded via CLEO-INJECTION.md @-reference
2. If the bridge content feels stale (>2 hours old), refresh:
   • cleo memory find "session task decision" --limit 10
3. Check for anti-patterns to avoid:
   • cleo memory find "mistake error avoid warning" --limit 5
4. 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:

1. Search brain:
   • cleo memory find "{claim-topic}" --limit 5
2. If results exist, verify your claim matches stored knowledge
3. 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.