에이전트 세션 핸드오프 규율

<!-- 에이전트 세션 핸드오프 규율 v0.1 · https://namtank96.github.io/assets/a04-handoff -->

# 세션 핸드오프: {작업명} (v0.1, YYMMDD)

> **목적**: 이 세션이 컨텍스트 한계로 끊길 때 다음 세션이 재스코핑 없이 이어받도록.
> 아래 항목은 전부 현행 산출물로 실측한 것이다. 기억으로 적지 않는다.
>
> **단일 writer 경계**: `{경로 A}` · `{경로 B}` = 이 세션 소유.
> 다른 세션이 동시에 편집하면 충돌한다. 경계 밖은 건드리지 않는다.
>
> **이 작업의 불변 원칙**: {3~5개. 매 세션 반복 설명하지 않기 위해 여기 고정}

---

## A. 이번 세션 완료

| 영역 | 항목 | 앵커 | 검증 |
|---|---|---|---|
| {영역} | {무엇을 했는가. 한 줄} | `{파일:함수}` `{식별자}` | {어떻게 확인했는가} |

**규칙**
- **앵커 없는 완료는 완료가 아니다.** 다음 세션이 파일을 열어 바로 찾을 수 있는
  파일명·함수명·식별자·줄번호를 적는다. "대시보드 개선함"은 앵커가 아니다.
- **검증 방법을 한 줄로 남긴다.** 재현 명령이면 명령을, 눈으로 본 것이면 무엇을 봤는지.
  검증하지 않았으면 "미검증"이라고 적는다. 비워두지 않는다.
- 완료 항목을 요약하지 않는다. 요약하면 다음 세션이 다시 열어봐야 한다.

## B. 남은 작업 (우선순위순)

- **{항목명}** `[S|M|L]`: {무엇을 해야 하는가. 착수 지점 포함}
  - 선행: {이게 끝나야 착수 가능한 것. 없으면 "없음"}
  - ⚠ **보류 권고**: {보류할 이유. 아래 규칙 참조}
- ~~**{완료된 항목}**~~ ✅ YYMMDD: {무엇을 했는지 + 앵커}

**규칙**
- **규모를 반드시 단다.** `S`=한 세션 일부, `M`=한 세션, `L`=여러 세션.
  규모가 없으면 다음 세션이 L짜리를 세션 끝에 집어 들었다가 반쯤 하고 또 끊긴다.
- **선행 의존을 단다.** 순서가 있으면 순서를, 없으면 "없음"이라고 적는다.
- **보류도 기록한다.** 안 하기로 한 것을 그냥 지우면 다음 세션이 똑같이 다시 검토한다.
  보류 사유는 구체적으로 적는다. "동작하는 코드를 리팩터해야 해서 회귀 위험",
  "요구가 확인되지 않은 투기적 기능", "디자인 세션 경계라 여기서 판단 불가" 같은 식.
- **완료 항목은 취소선으로 남긴다.** 지우지 않는다. 무엇이 이미 검토됐는지가 정보다.
- 우선순위를 붙이되, **"왜 이게 먼저인가"를 한 줄** 적는다.

## C. 핵심 결정 · 주의

- **{결정}**: {다음 세션이 이걸 모르면 되돌릴 결정}
- **{함정}**: {이미 한 번 밟은 함정. 다시 밟지 않게}

**규칙**
- 3~5개로 제한한다. 많아지면 아무도 안 읽는다.
- 판단 기준은 **"다음 세션이 이걸 모르면 내 작업을 되돌릴 것인가"** 하나다.
  되돌릴 만한 것만 적는다.
- 미구현을 정직하게 적는다. "아직 없음", "가짜 값", "임시 우회"를 숨기면
  다음 세션이 그걸 완성된 것으로 알고 위에 쌓는다.

## D. 원장 포인터

- 계획: `{마스터 로드맵 경로}`
- 변경 기록: `{항목별 상세 로그 경로}`
- 관련 스펙: `{경로}` · `{경로}`

**규칙**: 내용을 여기 복사하지 않고 경로만 적는다. 복사하면 두 벌이 되고 반드시 어긋난다.

---

# 이 규율을 쓰는 법

## 단일 writer 경계: 이 문서의 핵심

여러 세션이나 여러 사람이 한 작업에 병렬로 붙을 때, **작업 단위가 아니라 파일 단위로 쪼갠다.**

```
세션 1 = core/*.js · index.html
세션 2 = *.css · docs/*.md
세션 3 = 테스트 · 스크립트
```

"세션 1은 기능, 세션 2는 디자인"처럼 나누면 둘 다 같은 파일을 건드리고 충돌한다.
파일로 나누면 충돌이 구조적으로 0이 된다. 경계는 핸드오프 문서 맨 앞에 못박고,
경계를 넘어야 하면 그 세션에서 하지 말고 **다음 세션 항목으로 넘긴다.**

## 언제 쓰는가

- 컨텍스트가 60~70% 찼을 때. 다 차고 나서 쓰면 요약본밖에 못 쓴다.
- 세션을 의도적으로 끊을 때(작업 성격이 바뀔 때, 다른 사람에게 넘길 때).
- 하루를 마칠 때. 내일의 나도 남이다.

## 안티패턴

| 하지 말 것 | 왜 |
|---|---|
| "대략 이런 걸 했다"는 서술 요약 | 다음 세션이 결국 코드를 다 읽는다. 앵커를 적으면 안 읽어도 된다. |
| 남은 작업을 규모 없이 나열 | 세션 끝에 L짜리를 집어 들고 또 끊긴다. |
| 보류 항목 삭제 | 다음 세션이 똑같이 다시 검토하고 똑같이 보류한다. |
| 원장 내용을 본문에 복사 | 두 벌이 되고 어긋난다. |
| 완료 항목에 검증 방법 생략 | 다음 세션이 "됐다고 적혀 있는데 안 되는" 상태를 처음부터 다시 파헤친다. |
| 결정 사항을 10개 이상 나열 | 안 읽힌다. 되돌릴 만한 것만 남긴다. |