인수인계 문제
새 Claude Code 세션을 시작하면 모든 컨텍스트가 사라져요. 무엇을 작업하고 있었는지, 어떤 파일이 중요한지, 무엇이 남았는지 다시 설명해야 하죠.
/note-context는 다음 세션에 필요한 모든 것을 담은 파란 고정 메모를 만들어 이 문제를 해결해요.
출력 섹션
| 섹션 | 내용 |
|---|---|
| 헤더 | project @ branch | 커밋하지 않은 변경사항 N개 |
| 작업 중 | 현재 작업, 구체적이고 명확하게 |
| 핵심 파일 | 가장 중요한 파일 3-5개, 5단어 주석과 함께 |
| 상태 | 브랜치 목적, 커밋하지 않은 변경사항 요약, 루프 진행 상황 |
| 핵심 결정 | 이번 세션에 내린 결정만 |
| 미해결 질문 | 풀리지 않은 항목과 불확실한 부분 |
| 다음에 이어서 | 다음 세션을 위한 정확한 지침 |
핵심 파일 형식
각 파일에는 짧은 주석이 붙어요:
src/auth.ts — JWT validation middleware (refactoring)
src/api/users.ts — New endpoint, needs tests
tests/auth.test.ts — 3 tests failing on refresh최대 5개 파일. 가장 관련 있는 것만.
”다음에 이어서” 섹션
가장 중요한 섹션이에요. 품질 기준:
이 섹션만 읽어도 새 세션이 다음에 무엇을 해야 할지 정확히 알 수 있어야 해요.
좋은 예:
Resume With: Fix the refresh token flow in src/auth.ts:45.
The validateToken function needs to check token expiry
and call refreshToken() before returning 401.
Run tests with: npm test -- auth나쁜 예:
Resume With: Continue working on auth.항상 고정
컨텍스트 메모는 항상:
- 파란 색상
- 모든 창 위에 고정
- 3시간 미만이면 업데이트, 아니면 새 메모를 생성
활성 컨텍스트 메모는 한 번에 하나만 — 항상 최신 스냅샷이에요.
git 없는 모드
git 저장소 없이도 동작해요. git 관련 섹션(브랜치, 커밋하지 않은 변경사항)은 건너뛰고, 메모 상태와 제공한 컨텍스트에 집중해요.
타임스탬프
각 컨텍스트 메모에는 정확한 시간이 들어가요:
Context Feb 19, 2026 23:15