Use at the end of a session, milestone, or when closing a branch. Permanently records architectural decisions, "gotchas", and state changes to the long-term memory system so future agents don't repeat mistakes.
While session-distiller handles short-term context for subagents, Memory Maker is for long-term project persistence. It ensures that hard-earned knowledge doesn't disappear when the conversation thread is closed.
Determine if the information is:
use client at the very top").Use the mcp__serena__write_memory tool to persist the knowledge.
Naming Convention (memory_name):
topic/subtopic/detailauth/jwt/header_quirkarchitecture/state_managementglobal/nextjs/server_actionsContent Format:
# [Topic Title]
## The Decision / Rule
[State the rule clearly. E.g., "All dates must be stored as UTC ISO strings."]
## Why (The Context)
[Explain the reasoning or the bug that caused this rule.]
## Example
[Provide a quick code snippet of the right way and wrong way.]
If the knowledge represents a major shift, also update or append to ARCHITECTURE.md or CONTRIBUTING.md in the project root.