연속성 산출물(세션 인계 파일)
왕초보 설명
- 이게 뭐야? AI가 대화를 끝내기 전에 남기는 인수인계 메모 파일이다. 다음 대화의 AI는 이 파일만 읽고 바로 이어서 일한다.
- 왜 필요해? AI는 새 대화에서 이전 일을 하나도 기억하지 못한다. 메모가 없으면 매번 처음부터 다시 파악한다.
- 나는 뭘 하면 돼?
AGENTS.md에 두 줄을 적는다. “시작할 때session-handoff.md(또는PROGRESS.md)를 읽어라”, “끝낼 때 한 일 / 남은 일 / 막힌 것·결정 / 고친 파일을 적고 커밋해라”.
정의
새 세션이 이전 세션이 멈춘 곳에서 구두 설명 없이 재개하도록 저장소에 남기는 구조화된 상태 파일. 기본형은 진행 로그 + 검증 기록 + 다음 행동이고, 결정 로그와 git 체크포인트가 함께 쓰인다.
왜 중요한가
- 컨텍스트 창은 유한하고, 세션이 바뀌면 결정의 “왜”가 가장 먼저 사라진다.
- 핵심 지표인 재구축 비용(새 세션이 일할 수 있게 되기까지의 시간)을 직접 줄인다.
- 컨텍스트 리셋 전략은 이 산출물이 완전할 때만 작동한다.
등장하는 곳
- lecture-05:
PROGRESS.md,DECISIONS.md, git 체크포인트, 출근·퇴근 루틴의 네 도구로 정의한다. - project-02:
session-handoff.md(한 일 / 남은 일 / 결정 / 고친 파일 / 차단 / 다음 단계)로 두 번째 세션이 이어받는지 시험한다. - project-03:
session-handoff.md에 더해 기능별 시간대 로그claude-progress.md, 시작 점검init.sh, 종료 점검clean-state-checklist.md를 둔다. 단, 핸드오프의 “변경 없음” 기록이 실제 diff와 한 줄 어긋난다. - gajae-code, oh-my-claudecode: 하네스가 이 파일들(
goals.json·ledger.jsonl,prd.json·progress.txt)을 자동으로 쓰고 읽는다.
관련 개념
- initialization-phase: 첫 세션에서 인계 체계(진행 파일, 작업 목록)를 깔아 두는 단계.
- repo-system-of-record: 인계 파일도 저장소 안에 있어야 존재한다.
- context-anxiety: 리셋으로 불안을 피하려면 인계 파일이 완전해야 한다.
- definition-of-done: 인계 파일의 “완료” 항목은 완료 기준과 증거로 뒷받침돼야 한다.
상충·열린 질문
없음.