Review Spec

---
name: review-spec
summary: 이미 있는 명세를 심사 체크리스트와 대조해 빠진 것을 찾는다.
when: 구현을 시작하기 전, 또는 심사에서 반려된 뒤 원인을 명세로 되돌릴 때.
---

# review-spec

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

## 1. 대상을 정한다

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

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

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

특히 놓치기 쉬운 것:

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

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

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

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

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

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

```markdown
## 수용 기준

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

## 완료 확인

```bash
pnpm preflight
```

## 출력

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