Save Memory

---
name: save-memory
description: 이번 세션에서 알게 된 것을 단기 메모리에 저장하고, 필요하면 장기 메모리나 wiki로 승격한다. 세션을 마칠 때, 중요한 결정을 내렸을 때, 사용자 선호를 파악했을 때 사용.
allowed-tools: Bash, Read, Write, Edit, Grep, Glob
---

# /save-memory

세션의 맥락을 다음 세션이 이어받을 수 있는 형태로 남긴다.

## 1단계 — 무엇을 저장할지 고른다

이번 세션에서 다음에 해당하는 것을 찾으세요.

| 저장한다 | 저장하지 않는다 |
| --- | --- |
| 판단의 **근거** — 왜 A 대신 B를 골랐나 | 코드를 읽으면 알 수 있는 것 (구조, 시그니처) |
| 검토했지만 **버린 대안** | git log 가 이미 기록한 것 |
| 사용자의 **선호와 제약** | 이번 세션에서만 의미 있는 임시 상태 |
| 막힌 지점과 그 이유 | 이미 wiki 에 있는 내용 |
| 다음 세션이 이어서 해야 할 것 | 일반적인 기술 지식 |

저장할 것이 없으면 **없다고 말하고 끝내세요.** 억지로 만든 메모리는 다음 세션의 노이즈입니다.

## 2단계 — 기존 메모리와 대조

```bash
ls wiki/memory/short-term/ wiki/memory/long-term/
```

같은 주제의 파일이 있으면 **새로 만들지 말고 그 파일을 갱신하세요.** 중복 메모리는 서로 어긋나면서
어느 쪽이 맞는지 알 수 없게 만듭니다.

내용이 틀린 것으로 밝혀진 메모리는 삭제하세요. 오래된 메모리보다 틀린 메모리가 위험합니다.

## 3단계 — 단기 메모리 작성

```bash
pnpm memory:new <kebab-case-topic>
```

스크립트가 템플릿에서 파일을 만들고 경로를 출력합니다. 그 파일을 채우세요.

- 한 파일에 한 주제. 세션 요약을 뭉뚱그리지 마세요.
- 상대 날짜 금지. "어제" 대신 `2026-07-27`.
- `type` 을 정확히: `decision` / `observation` / `preference` / `blocker` / `progress`
- **왜**를 반드시 남기세요. 무엇을 했는지는 git 이 압니다.

## 4단계 — 승격 판단

```
단기 ──(3회 이상 참조 / 계속 참으로 확인)──▶ 장기 ──(프로젝트 규칙이 됨)──▶ wiki
```

### 단기 → 장기

다음 중 하나면 승격합니다.

- 같은 내용이 세 번 이상 참조되었다
- 프로젝트가 존재하는 한 계속 참이다
- 사용자 선호로 확인되었다 (`type: preference` 는 승격 1순위)

```bash
pnpm memory:new <topic> --long
```

내용을 옮기고, 원본 단기 메모리에 `promoted: true` 를 설정한 뒤,
**`wiki/memory/index.md` 에 한 줄을 추가하세요.** 이 갱신을 빠뜨리면 SessionStart 훅이 그 메모리를
로드하지 않습니다.

### 장기 → wiki

다음 중 하나면 wiki 문서나 ADR 로 승격합니다.

- 다른 사람이나 에이전트가 따라야 할 **규칙**이 되었다 → `wiki/0N-*.md` 갱신
- 되돌리기 어려운 **아키텍처 결정**이다 → `wiki/decisions/ADR-NNNN-*.md` 신규 작성

wiki 로 승격했으면 `wiki/06-history.md` 에 타임라인 항목을 추가하세요.

## 5단계 — 정리

30일이 지난 `type: progress` 메모리 중 완료된 것은 삭제합니다.
해결된 `blocker` 도 삭제하거나 결과를 담아 `decision` 으로 바꿉니다.

```bash
find wiki/memory/short-term -name '*.md' -mtime +30
```

삭제 전에 사용자에게 목록을 보여주고 확인받으세요.

## 6단계 — 보고

무엇을 저장했고 무엇을 승격했는지 한 문단으로 요약합니다. 파일 경로를 포함하세요.

## 하지 말아야 할 것

- 메모리 파일에 코드를 복사해 넣지 마세요. 경로와 판단 근거만 남깁니다.
- `wiki/memory/index.md` 에 메모리 본문을 쓰지 마세요. 한 줄 링크만입니다.
- 확신 없는 내용에 `confidence: high` 를 붙이지 마세요.
- 사용자 확인 없이 wiki 의 기존 문서를 크게 고치지 마세요. 갱신 제안을 먼저 하세요.