Save a Decision to Memory

The user wants to explicitly record a specific decision. They may provide the decision as an argument (e.g.,

/ltm:save chose Stripe for payments

) or describe it in their message.

What to do

1. Read

   .memory/DECISIONS.md

   to check for existing related entries.

2. Parse the user's input to understand the decision being recorded.

3. Check for duplicates — if a similar decision already exists, update it rather than creating a new entry.

4. Add the decision to the appropriate section in

   .memory/DECISIONS.md

   :
   • Use a

     ### heading

     with today's date
   • Include up to ~10 lines of context explaining the decision and rationale
   • Place it under the most fitting

     ## Section

     heading (create a new section if none fits — sections are free-form)
   • If the decision supersedes a prior one, update the old entry in-place and add a Changelog entry

5. If the decision is complex and the user provided extensive rationale:

   • Create a detail file at

     .memory/details/YYYY-MM-DD-<topic>.md

   • Keep the main file entry concise with a link to the detail file

6. Update the

   > Auto-maintained by claude-ltm. Last updated:

   date.

7. Confirm to the user what was saved and where.

Detail file format

When creating a detail file in

.memory/details/

, use this structure:

---
decision: <title>
date: YYYY-MM-DD
status: ACTIVE
---

<!-- Valid status values: ACTIVE, SUPERSEDED -->

## Context
[Why this decision was needed — 2-3 sentences]

## Decision
[What was chosen and why — concise]

## Alternatives Considered
- Option B: [why rejected]

## Impact
- [Key consequence 1]