aipmandy/dna-memory/dna-memory-loop

DNA Memory Loop

Use DNA Memory as the cross-client long-term truth. Treat each client's native history as a transcript source, not as a competing durable memory store.

Before substantive work

You MUST recall before relying on history. Treat a task as history-dependent when it refers to prior work, asks to continue, mentions last time or the same plan, names an existing project or path, or depends on a durable preference, known error, workflow, project state, or open loop.

1. Extract one to four distinctive terms from the request, project, error, or expected result.
2. Call memory_recall separately for each term. Always pass the real client:

use client=codex, client=claude-code, or client=hermes for those runtimes. Never invent client or session metadata. Pass the current stable session ID only when the runtime exposes it; otherwise omit session_id instead of using a placeholder.

1. Deduplicate by memory ID. Inject at most five memories and about 2,000 tokens total.
2. Use only relevant results. Current files, processes, remote state, and tests override stale memory.

Skip recall for simple, self-contained work such as translation, current time, one-step formatting, or a command that does not depend on history.

Feedback

• Call memory_feedback(..., outcome="useful") only when a recalled memory changed or confirmed the work.
• Use outcome="misleading" when a memory sent the task in the wrong direction.
• Do not submit feedback for a result that was displayed but not used.

After verification

Call memory_remember only for a durable preference, decision with rationale, fact, insight, reusable workflow, proven error lesson, project state, or open loop. Write a compact conclusion with bounded source pointers. Never store a full transcript, credentials, raw prompts, or large tool output.

When current evidence invalidates an older conclusion, read the older memory IDs and pass only those exact IDs through supersedes. Never infer replacement from project or type alone.

When a native session has a stable source pointer, call memory_close_session with bounded metadata. This records provenance, not transcript content.

Bounded proposals

If the client cannot directly call memory_remember, it may append up to three reviewable candidates to its final message:

DNA_MEMORY_PROPOSAL {"type":"decision|fact|workflow|preference|insight|error_lesson|project_state|open_loop","summary":"verified reusable conclusion","confidence":"high|medium|low","importance":0.0}

Keep each summary under 800 characters. A proposal remains a candidate until maintenance applies type, sensitivity, capacity, and deduplication checks.

Degraded mode

Memory failure must not block the main task. Continue from current evidence, report the degraded capability once, and never fabricate recall, feedback, or writeback success.