review-spec

명세는 한 번 쓰고 끝나지 않는다. 심사 기준이 갱신되고, 구현하면서 알게 된 것이 생긴다.

1. 대상을 정한다

ls specs/*.md
pnpm preflight            # 어떤 명세가 error 인지

2. 심사 체크리스트와 대조한다

wiki/04-review-checklist.md 를 열고, 이 기능이 건드리는 영역을 위에서부터 훑는다.

특히 놓치기 쉬운 것:

영역	자주 빠지는 항목
내비게이션	뒤로가기 버튼이 두 개 동시에 보이지 않는가
사용성	진입하자마자 바텀시트가 뜨지는 않는가
사용성	다른 앱 설치나 자사 서비스로 유도하지 않는가
권한	권한이 거부돼도 기능이 도는가
로그인	토스 로그인 외 다른 로그인 수단을 만들지 않았는가
결제	취소하면 주문 화면으로 돌아오는가
광고	인트로·로딩·팝업 같은 임시 화면에 광고를 넣지 않았는가

3. 구현과 어긋난 곳을 찾는다

grep -n "path:" apps/miniapp/src/App.tsx     # 실제 라우트
ls apps/miniapp/src/screens/                 # 실제 화면

명세에 없는 화면이 있으면 둘 중 하나가 틀린 것이다. 화면을 지우거나 명세를 갱신한다. 임의로 판단하지 말고 사람에게 어느 쪽인지 묻는다.

4. 반려를 명세로 되돌린다

심사에서 반려됐다면 그 사유를 수용 기준으로 추가한다. 같은 이유로 두 번 반려되지 않게 하는 유일한 방법이다.

## 수용 기준

- [ ] (2026-08-07 반려 반영) 광고 시청 중 배경음이 멈춘다

완료 확인

pnpm preflight

출력

• 검토한 명세
• 추가한 수용 기준
• 명세와 구현이 어긋난 곳 (사람의 판단이 필요한 것)