turbo_quant_memory: Instructions file for Codex

AGENTS.md

Project Identity

• Project name: Turbo Quant Memory for AI Agents
• Project slug: turbo_quant_memory
• Memory user_id: tq_memory_agents_20260325_default
• Default sessionId: default

Memory Usage Policy

• Use project-scoped memory by default.
• Use global memory only for reusable cross-project knowledge.
• Prefer hybrid search with project bias when reading.
• Require explicit promotion from project to global memory.
• Every memory result must preserve provenance.
• Before editing an existing area, search project memory first.
• Use hydrate only when compact retrieval is not enough.
• After important decisions, debugging outcomes, or handoffs, store one concise note.
• After README, config, workflow, or architecture changes, refresh indexed docs.
• When old knowledge is replaced, write the new note and deprecate the old one.
• Do not keep smoke, temporary, or validation notes active.
• Treat .planning, .serena, and generated benchmark artifacts as historical workflow context, not as primary user-facing memory.
• Use Knowledge Graph relations (link_entities, unlink_entities, get_related_entities) to build associations between notes, source files, issues, or tasks, enabling association-based semantic retrieval.

Session Continuity (start-of-session and compaction)

• At session start, or right after a context compaction, call recent_context FIRST. It is query-free and returns the most recently updated notes, including session handoff notes — the reliable "where did I leave off" entry point when you do not yet know what to search for. In hybrid scope the current project's notes fill the window first; other projects' promoted notes only backfill leftover slots (pass scope="global" for cross-project news).
• Before a long pause or an expected compaction, write one handoff note (remember_note(kind="handoff", ...)) summarising mission, decisions, files touched, current state, and open questions. Handoffs land in the episodic tier.
• semantic_search excludes episodic by default so session noise does not drown durable knowledge. To retrieve handoffs by query, pass tier_filter=["episodic"]; recent_context includes them automatically.
• Asking "what did we decide/learn about X"? Pass source_filter="notes" — in doc-heavy projects the indexed markdown blocks otherwise crowd decision/lesson notes out of the top ranks. source_filter="markdown" narrows to docs only.
• Use tier="durable" on remember_note only when a session-bridging note must also appear in ordinary searches.