# Memory Handoff

## Type

setup | workflow | bugfix | decision | security | preference | research | project-context

## Title

Short, specific title. No private identifiers.

## Summary

2-4 sentences. What happened and why it matters for future sessions.

## Durable facts

- Fact 1
- Fact 2
- Fact 3

## Evidence

- files changed: `path/to/file`
- commands run: `the exact command`
- error strings: `verbatim error`

## Recommended memory action

create-card | update-card | no-card

Choose exactly one branch below, then delete the other branch before saving.
Card actions must omit document sections entirely. `no-card` actions must omit card sections entirely.

<!-- CARD ACTION BRANCH: keep only for create-card or update-card. -->

## Target card

card-name-if-known.md

## Suggested card content

If `create-card` or `update-card`, paste the exact card content here. Must start with YAML frontmatter:

```markdown
---
topic: ...
category: ...
tags: [list]
---

# Card title

Card body. Use ### or deeper for subsections; ## headings parse as new handoff sections.
```

<!-- NO-CARD ACTION BRANCH: keep only for no-card. -->

## Target document

If `no-card`, name one of: `TOOLS.md` | `USER.md` | `rules/<name>.md` | `.learnings/LEARNINGS.md` | `.learnings/ERRORS.md` | `.learnings/FEATURE_REQUESTS.md`

## Suggested document content

If `no-card`, the exact text to append. No `##` headings (use `###` or deeper).
