---
name: session-note
description: Use at the start of a work session (첫 요청을 받았을 때) to restore what was in progress, and after each confirmed screen to record it — 작업 맥락을 docs/tasks/<slug>.md에 남겨 다음 세션이 처음부터 다시 묻지 않게 한다. 사용자가 "어디까지 했지", "이어서 하자"라고 할 때도 로드.
---

# Session Note — 다음 세션이 맥락을 잃지 않게

대화는 세션이 끝나면 사라진다. 비개발자 사용자는 며칠에 걸쳐 화면을 만들고, 다음 세션에서 **"뭘 만들고 있었는지"를 다시 설명할 방법이 없다.** 그 맥락을 파일로 남긴다.

체크포인트(`checkpoint`)가 **코드**의 되돌아갈 지점을 남긴다면, 세션 노트는 **의도와 진행 상태**를 남긴다. 둘은 짝이다.

## 파일

`docs/tasks/<slug>.md` — slug는 기능 이름(`applicant-list`, `usage-dashboard`). `start-feature`가 저장하는 `docs/specs/<slug>.md`(요구 원문)와 같은 slug를 쓴다.

```markdown
# 지원자 목록 화면

- 상태: 만드는 중
- 마지막 확인: 목록이 표로 뜨고 이름 검색이 됨

## 지금까지 정한 것

- 표에 이름·지원일·상태를 보여준다 (기획서 2쪽)
- 상태는 색 배지로 — 합격 초록, 대기 회색

## 다음에 할 것

- 이름을 누르면 상세가 열리게
- 상태별 필터

## 미뤄둔 것

- 엑셀 내려받기 — 기획이 아직 없어서 보류
```

## 언제 쓰나

1. **세션 시작 — 첫 요청을 받았을 때.** `docs/tasks/`를 확인한다. 노트가 있으면 **읽고 화면 언어로 먼저 알린다**: "지난번에 지원자 목록까지 만들어뒀어요. 이름을 누르면 상세가 열리게 하는 게 다음 차례였는데, 이어서 할까요?" 노트가 없으면 아무 말 없이 평소대로 진행한다.
2. **화면을 확인받은 뒤** (`show-screen` 다음, 임시저장과 같은 지점). 노트의 `마지막 확인`·`다음에 할 것`을 갱신한다 — 조용히, 한 줄 보고도 하지 않는다.
3. **기능이 끝났을 때.** 상태를 `완료`로 바꾸고 남은 미뤄둔 것만 남긴다.

## 규칙

- **노트는 짧게 유지한다.** 20줄을 넘기면 지난 결정은 지우고 현재 상태만 남긴다 — 히스토리는 저장 기록(checkpoint)이 갖고 있다.
- **화면 언어로 쓴다.** 컴포넌트명·파일 경로·git 용어를 쓰지 않는다. 사용자가 열어봐도 읽히는 문장이어야 한다.
- **결정만 적고 코드는 적지 않는다.** 코드는 코드에 있다.
- 노트를 근거로 **사용자에게 묻지 않고 다음 작업을 시작하지 않는다** — 항상 "이어서 할까요?"로 확인받는다.
- 여러 기능을 동시에 만들면 노트도 여러 개다. 세션 시작 때는 **가장 최근에 고친 노트** 하나만 꺼낸다.
