remember

name	remember
description	Capture corrections, decisions, or learnings to persistent agent memory files

Remember

Use this skill when:

• The user corrects your behavior or output.
• An architectural or tooling decision is made.
• A non-obvious project convention is established.

Steps

1. Identify the type

• Correction — the user told you something was wrong or should be done differently.
• Decision — a choice was made between alternatives (tooling, architecture, patterns).

2. Append to the appropriate file

• Corrections → .agents/memory/corrections.md
• Decisions → .agents/memory/decisions.md

3. Follow the entry format

Use the format documented at the top of each file. Include today's date, a short title, and enough context that a future agent (with no prior session history) can understand and apply it.

Appending correctly: Memory files are append-only. Before using StrReplace, read the end of the file to find the true last entry. Anchor your replacement on that entry's final line — don't assume from session memory which entry is last. Getting this wrong inserts entries mid-file.

4. Keep entries concise

Each entry should be 2–5 lines. Don't duplicate what's already in AGENTS.md — memory files capture project-specific learnings, not general coding rules.

5. Consider an AGENTS.md amendment

If the correction or decision reflects a general rule that should apply to all future work (not just a one-off), propose an amendment to AGENTS.md per the "Proposing amendments" section.