---
name: weekly-review
description: 한 주의 회고 메모(inbox/회고-*.txt 여러 개)를 templates/주간회고.md 양식(KPT — 잘한 것·아쉬운 것·다음 주에 할 것)으로 정리해 notes/에 주간 회고로 저장한다. "주간 회고 써 줘", "이번 주 회고 정리", "KPT 정리" 같은 요청에 쓴다. 회의 메모는 meeting-notes, 공부 필기는 study-notes 를 쓴다.
---

# weekly-review — 회고 메모 → 주간 회고

## 언제 쓰나

- 금요일(또는 주말)에 그 주의 `inbox/회고-YYYY-MM-DD.txt` 메모들을 모아 주간 회고로 정리할 때
- 예: "이번 주(10/27~10/31) 회고 정리해 줘"

## 읽을 파일 (순서대로)

1. `CLAUDE.md` — 이 폴더의 정리 규칙 5개
2. `templates/README.md` — 양식 사용법과 점검표
3. `templates/주간회고.md` — 쓸 양식
4. 그 주(월~일) 날짜의 원본 메모 `inbox/회고-YYYY-MM-DD.txt` **전부** — **읽기만 한다. 절대 고치지 않는다.**
   - 찾는 법: `ls inbox/회고-*.txt` 로 목록을 보고 파일명 날짜가 그 주에 드는 것만 고른다.
   - 어느 주인지 요청에 없으면 오늘이 속한 주로 한다.

## 쓸 양식

`templates/주간회고.md`를 그대로 복사해 `{{ }}` 자리만 채운다. 본문 칸은 **잘한 것 (Keep) → 아쉬운 것 (Problem) → 다음 주에 할 것 (Try)** 세 개뿐이고, 이름·순서를 바꾸거나 칸을 더하지 않는다.

칸별로 채우는 법:

- **제목** — 그 주 월요일~마지막 메모 날짜. 예: `# 주간 회고 — 2026-10-27(월) ~ 10-31(금)`
- **원본 메모 주석** — 제목 아래 주석에 읽은 메모 파일을 모두 적는다. 예: `<!-- 원본 메모: inbox/회고-2026-10-29.txt · 회고-2026-10-30.txt -->`
- **잘한 것** — 1~3개, `무엇을 — 왜 잘됐는지`. 숫자(판매 개수·좋아요 수)가 메모에 있으면 날짜와 함께 근거로 붙인다.
- **아쉬운 것** — 1~3개, `무엇이 — 왜 그랬는지`.
- **다음 주에 할 것** — 1~3개, `- MM/DD(요일): 행동`. 메모에 적힌 다짐·계획에서만 가져온다.
- "왜"나 날짜가 메모에 없으면 지어내지 말고 그 자리에 `(메모에 없음)`. 메모의 추측은 `(메모의 추측)`이라고 표시한다.
- 칸 하나에 넣을 게 메모에 없으면 칸을 지우지 않고 `- (메모에 없음)`이라고 쓴다.

날짜: 본문은 `10/29(수)`처럼 월/일 + 괄호 요일. 요일은 달력으로 확인한다(`date -j -f %Y-%m-%d 2026-10-29 +%a`).

**메모에 없는 내용은 지어내지 않는다.** 여러 날 메모를 합칠 때 숫자를 더하거나 바꿔 쓰지 말고, 메모에 적힌 숫자를 그 날짜와 함께 옮긴다.

## 저장 위치

- `notes/주간회고-YYYY-MM-DD.md` — 날짜는 **그 주 월요일** (메모 날짜가 아님)
- 예: 10/29~10/31 메모 → `notes/주간회고-2026-10-27.md`
- 같은 이름의 파일이 이미 있으면 덮어쓰기 전에 사용자에게 묻는다.

## 끝나고 확인할 점검표

저장한 파일을 다시 열고 위에서부터 확인한다. 하나라도 ✗면 고친 뒤 다시 확인한다.

**공통**
- [ ] 칸 이름과 순서가 양식과 같다 (지운 칸이 없다 — 쓸 게 없으면 `(메모에 없음)`)
- [ ] `{{`가 하나도 남아 있지 않다 (`grep -n '{{' notes/주간회고-....md` 결과가 비어 있음)
- [ ] 날짜에 요일이 붙어 있고, 파일명 날짜(월요일)와 제목 시작 날짜가 같다
- [ ] 숫자·이름·날짜를 원본 메모와 한 번 대조했다 (가격 6,000원 오기 같은 실수 방지)
- [ ] 메모에 없는 내용을 지어내지 않았다
- [ ] `inbox/` 원본을 고치지 않았다 (`git status inbox/`에 이번 작업으로 생긴 변경이 없음)

**주간 회고 (KPT)**
- [ ] 그 주의 회고 메모를 빠짐없이 읽었고, 원본 메모 주석에 전부 적었다
- [ ] 본문 칸이 잘한 것 / 아쉬운 것 / 다음 주에 할 것 세 개뿐이고 이 순서다
- [ ] 세 칸 모두 1개 이상 적혀 있다 (메모에 없으면 `(메모에 없음)`)
- [ ] 잘한 것·아쉬운 것에 각각 "왜"가 붙어 있다 (메모에 없으면 `(메모에 없음)`)
- [ ] 다음 주에 할 것이 날짜가 있는 행동이고, 아쉬운 것 중 최소 하나와 이어진다

마지막으로 사용자에게 저장 경로, 읽은 메모 개수, `(메모에 없음)`으로 남긴 자리를 알려 준다 — "왜"를 본인이 채울 수 있게.