session-end

Language: 한국어 | English

session-end는 코딩 세션을 종료하거나 중간 checkpoint를 남길 때, 다음 AI 세션이 바로 이어받을 수 있도록 handoff 파일을 정리하는 Codex skill입니다.

AI 코딩 세션은 thread가 끝나면 단기 맥락을 잃기 쉽습니다. 이 skill은 마지막 정리 단계를 표준화해서, 다음 세션이 채팅 기록만이 아니라 repo 안의 구체적인 파일에서 작업 상태를 복구할 수 있게 합니다.

무엇을 업데이트하나

• CLAUDE.local.md: 다음 세션이 바로 읽을 짧은 handoff
• docs/session-logs/YYYY-MM-DD.md: 장기 세션 로그
• roadmap.progress.json: 이미 존재하는 경우에만 진행 상태 갱신
• .gitignore: CLAUDE.local.md가 공개 repo에 들어가지 않도록 유지

설치

GitHub에서 설치:

npx skills add bishoe01/end_session_skill --yes --global --agent codex

이 repo를 로컬에서 개발 중일 때:

npx skills add . --yes --global --agent codex

수동 설치:

mkdir -p ~/.codex/skills
cp -R . ~/.codex/skills/session-end

Codex를 재시작하거나 새 세션을 연 뒤 사용합니다:

/session-end

slash command가 보이지 않으면 자연어로 요청해도 됩니다:

Use the session-end skill to checkpoint this session.

데모

포함된 dummy project에 helper를 실행합니다:

npm run demo

이 명령은 examples/dummy-project/를 임시 디렉터리로 복사한 뒤 handoff 파일을 생성합니다. 다른 repo를 건드리지 않고 결과 구조를 확인할 수 있습니다.

검증

npm run validate
npm run demo

helper script는 선택 사항입니다. 실제 skill은 Codex가 프로젝트 상태를 확인하고, 필요한 handoff 파일을 직접 검토한 뒤 업데이트하도록 안내합니다.