nowledge-mem

name	nowledge-mem
description	Cross-tool knowledge for Amp. Read startup Context Bundle, search past decisions and conversations, save durable insights, and capture sessions as searchable threads with Nowledge Mem.

Nowledge Mem

You have Nowledge Mem tools (nowledge_mem_*) for cross-tool knowledge management. Use them proactively.

At session start

Call nowledge_mem_context_bundle when identity, scope, or rules may matter. It returns owner identity, resolved AI Identity, active scope, active rules, Working Memory, and KFS paths in one stable contract. Use nowledge_mem_working_memory only for a lightweight daily briefing or as a fallback when the Context Bundle is unavailable.

When to search (nowledge_mem_search)

Search proactively when past context would improve the answer. Strong signals:

• The user references previous work, a prior fix, or an earlier decision
• The task resumes a named feature, bug, refactor, or subsystem
• A debugging pattern resembles something solved earlier
• The user asks for rationale, preferences, procedures, or recurring workflow details
• The user uses recall language: "that approach", "like before", "the pattern we used"

Do not search when the topic is fundamentally new, when the answer is generic documentation, or when the user explicitly wants a fresh perspective.

When to search threads (nowledge_mem_thread_search)

• The user asks about a prior conversation or exact session history
• A memory result references a source thread

When to save or update

Save proactively when the conversation produces a durable fact, preference, decision, plan, procedure, learning, event, or important context. Do not wait to be asked. Search first to check for related memories:

• If a related memory exists, call nowledge_mem_update to refine it
• If the insight is genuinely new, call nowledge_mem_save

Good candidates: decisions with rationale, repeatable procedures, lessons from debugging, durable preferences, plans future sessions will resume. Skip routine fixes, in-progress work, and generic Q&A answerable from documentation.

When to save the session (nowledge_mem_save_thread)

• The user asks to save the conversation or "remember this session"
• A long, productive session is wrapping up
• The conversation produced decisions or context worth preserving as a full thread

Session capture also happens automatically at the end of each agent turn; the tool is the explicit, on-demand path and is idempotent.

When to save a handoff (nowledge_mem_save_handoff)

Use a handoff when you want a curated summary rather than the full transcript: provide a topic and a structured summary (Goal, Decisions, Key files, Risks, Next steps).