memory-remember

name	memory-remember
description	Store a memory into the appropriate Engram file. Trigger when a new preference, decision, milestone, or natural conversation summary point is identified, or when the user explicitly asks to remember something.

Memory Remember

Store information into the appropriate memory file.

When to Use

Trigger proactively — do not wait for the user to ask — when:

• A new user preference or decision is discovered during conversation
• A milestone, architecture decision, or lesson learned is identified
• The conversation reaches a natural summary point or is ending
• The user explicitly asks to remember something

Workflow

1. Read Configuration

Read .claude/memory-settings.json to get the configured file names.

2. Get Current Timestamp

Before writing, run date '+%Y-%m-%d %H:%M' via Bash to get the current timestamp. Use this for any dated entry. Use date '+%Y-%m-%d' when only a date is needed.

3. Classify Content

Determine which file the memory belongs to:

Type	Target File	Examples
Preference	preferences file	User likes, dislikes, habits, settings, personal info, project conventions
Conversation Summary	conversations file	What was discussed, tasks completed, decisions made in this session
Long-Term Memory	longterm file	Life events, milestones, architecture decisions, lessons learned, relationship changes

4. Write to Appropriate File

Preferences File

• Read the current file
• Find the appropriate section for the new information
• Edit the existing section content (update, don't duplicate)
• Update the Last Updated: {DATE} header to today's date

Conversations File

• Prepend new entry to the TOP of the file (below the header, above existing entries)
• Format: ### YYYY-MM-DD HH:MM - Topic (use the timestamp from step 2)
• Include: brief summary of what was discussed, key decisions, action items
• Keep summaries concise (3-8 lines)

Long-Term Memory File

• Append to the appropriate section within the file
• Format: - YYYY-MM-DD: Description (use date from step 2)
• NEVER delete existing entries — only add new ones
• Place under the correct subsection (Milestones, Decisions, Lessons Learned, etc.)

5. Confirmation

Briefly mention what was saved (one line), e.g.:

• "Noted your preference for TypeScript over JavaScript."
• "Saved conversation summary about the auth refactor."
• "Recorded the migration to PostgreSQL as an architecture decision."

Do NOT be verbose about the saving process — keep it natural and seamless.