# 코드 변경 핸드오프 시 "앱 재빌드·재시작" 단계를 명시할 것

커밋·테스트(L1) 통과 ≠ 사용자가 보는 **실행 중 앱에 반영**. bibimbap dev 앱은
호스트 JVM(IDE 번들 JDK, 8080) 또는 compose `bibimbap-app` 로 구동되며, 소스/JSP 변경은
프로세스를 재빌드·재시작하기 전까지 반영되지 않는다.

## 적용
- 코드 변경을 마무리할 때 `needs_user_verification`/배포후 체크리스트에 **"앱 재빌드·재시작"을 첫 단계로 명시**.
  스모크 절차는 그다음. "커밋했으니 됨" 으로 핸드오프하지 말 것.
- 신규 서버 기능(엔드포인트·매퍼) 추가 시 특히. 구 JSP 가 서빙되면 클라이언트 전용 동작(예:
  로그아웃 상태에서 좋아요가 눌리고 카운트가 로컬에서만 변함)이 그대로 보여 "안 고쳐졌다" 로 오인된다 —
  이 증상이 보이면 코드 결함이 아니라 미재배포 신호.
- 재배포 명령은 `mem:local-dev-setup-gotchas` + `docs/development/local-dev-setup.md` 의
  "코드·JSP 변경 후 재빌드·재시작" 표 참조.

## 왜
세션 20260629-171042: 직전 좋아요 영속화 수정(L1 PASS, 커밋 fa6a301)을 사용자가 더미 게임에서
테스트했으나 "안 됨". 원인은 코드가 아니라 **돌던 앱이 구 버전**. orchestrator 가 재배포 단계를
needs_user_verification 에 안 적었고(컨테이너 검증만 함), 사용자가 "애초에 니가 해줬어야 / 가이드에
기재하라" 고 지적. docs-first 로 가이드에 반영 완료.

근거 세션: .atp/work-session/20260629-171042.