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.