viberoom-web/docs/05_handoff_checklist.md

05. Handoff Checklist

Codex CLI가 중단되거나 컨텍스트가 초기화된 뒤 재개할 때 사용하는 체크리스트.

재개 시작 (5분)

1. docs/README.md에서 지금 작업할 화면 섹션과 우선 읽기 문서를 확인
2. git status --short로 작업 트리 상태 파악
3. docs/work.md와 docs/90_current_state.md의 현재 우선순위를 확인
4. 화면 작업이면 해당 source-of-truth spec을 추가로 읽는다
   • /app -> 19, 18, 15
   • /space -> 10, 11, 13
   • /stats -> 14, 15

구현 중 체크

1. 뷰 로직 누수 여부 확인 (page.tsx 조합 유지)
2. 레이어 import 방향 위반 여부 점검
3. 파일 500줄 초과 여부 점검
4. UI 톤(감성/저자극)과 CTA 위계 유지 확인

종료 전 체크

1. 타입체크 또는 빌드 최소 1회 실행
2. 변경 파일 경로/의도 요약 정리
3. docs/90_current_state.md 갱신:
   • DONE
   • NEXT
   • RISKS
   • CHANGED FILES

커밋 단위 가이드

• 1커밋 1의도 원칙
• 구조 변경(FSD)과 스타일 변경(UI)은 가능하면 분리
• 커밋 메시지는 "무엇을 왜 바꿨는지" 중심으로 작성