클린 상태

왕초보 설명

  • 이게 뭐야? 세션을 끝낼 때 “다음 사람이 아무것도 고치지 않고 바로 일을 시작할 수 있는 상태”로 두는 것이다.
  • 비유: 공용 주방. 설거지 끝내고, 불 끄고, 다 쓴 재료는 메모해 두고 나간다.
  • 나는 뭘 하면 돼? clean-state-checklist.md를 만들어 빌드·테스트·진행 기록·임시 파일·앱 실행 다섯 가지를 체크하게 하고, AGENTS.md에 “이 체크리스트를 통과해야 세션 완료”라고 적는다.

정의

세션 종료 시 다섯 조건을 모두 만족하는 상태: 빌드 통과, 테스트 통과(기존 테스트 포함), 진행 상황 기록됨, 오래된 산출물·디버그 코드 없음, 표준 시작 경로 사용 가능. 하나라도 빠지면 세션은 완료가 아니다.

왜 중요한가

  • 엔트로피 증가가 기본값이라, 정리하지 않으면 매 세션 엉망이 쌓이고 다음 세션은 진단부터 한다.
  • 세션 종료 상태가 다음 세션의 시작 비용을 정한다.
  • DB 트랜잭션처럼 “완전히 커밋하거나 롤백”하는 세션 무결성의 실천이다.

등장하는 곳

  • lecture-12: 다섯 차원, 세션 종료 체크리스트, 즉각 정리 + 주간 클린업 루프, 멱등 정리.
  • project-03: clean-state-checklist.md의 “범위 통제 검증” 묶음(모든 기능 pass, 기능별 증거 등).
  • project-04: clean-state-checklist.md를 Build / Architecture / Runtime / Data Integrity / Repository로 나누고, “커밋 전과 세션 끝에 실행”하라고 적는다. scripts/check-architecture.sh와 구조화 로그 확인이 체크 항목에 들어간다.
  • project-05: 세 변형 디렉터리 모두 clean-state-checklist.md를 둔다.
  • project-06: solution에 clean-state-checklist.md(- [ ] 41개)와 데이터 디렉터리 불일치를 찾는 scripts/cleanup-scanner.sh, 멱등 “클린 상태 리셋” 기능이 있다.

관련 개념

상충·열린 질문

  • lecture-12의 다섯 차원 중 “기능 목록 업데이트”는 project-04 체크리스트에 없다(project-04에는 feature_list.json 자체가 없다). 대신 “최종 요약에 현재 상태·검증·남은 위험 기록”이 있다.