데모 리뷰 플로우은(는) 무엇을 하나요?
테스트와 코드 리뷰는 메커니즘을 증명합니다. 그러나 메뉴가 잘못된 위치에 있거나, 닫기 버튼이 깜박이거나, 아이콘이 2px 낮게 위치하는 것은 말해주지 않습니다. 오직 사용자만이 알 수 있습니다. 따라서 보거나 조작하는 변경 사항은 제품 코드보다 먼저 사용자가 각 기능을 승인하는 작동하는 데모로 설계되며, 사용자가 실제 앱에서 수락할 때만 종료됩니다. 리뷰 보드(공유 데이터베이스가 있는 Artifact 페이지)는 6가지 상태를 통해 모든 기능을 추적합니다.
프로젝트 구성: .claude/demo-board.md (보드 URL, 영역별 참조 앱, 확인할 너비, 라이브 앱 + 실제 데이터 보유 여부, 워크스페이스 복사 포트, 게이트 명령, 스펙 파일). 없으면 먼저 보드 생성: references/board-setup.md.
어떤 경로
- 무언가의 모양, 위치, 또는 조작 방식을 변경 → 이 플로우. 크기나 마감 기한 예외 없음.
- 스펙 또는 승인된 데모가 이미 정의한 동작 복원 (충돌, 잘못된 데이터, 오버플로, 회귀) → TDD로 직접 수정, 데모 불필요. 사용자에게 어떤 경로로 판단했는지 알림.
- 출시된 보드 항목에 대해 보고된 버그 →
porting으로 돌아가서 수정, 라이브 확인,shipped. 모양을 변경하는 수정 → 새로운 데모 라운드.
플로우
- 참조 먼저. 해당 영역에 대해 사용자가 이미 알고 있는 앱을 조회합니다(구성에 나열됨). 컨트롤 위치, 각 키, 종료를 포함한 동작을 기록합니다. 명시된 이유가 있을 때만 이탈합니다. 시뮬레이션된 사용자 설문 조사가 옵션 간 선택을 도와줍니다. 참조를 대체하지는 않습니다.
- 실제 UI 측정. 변경 사항이 닿는 출시된 화면을 사용자의 너비로 읽기 전용 스크린샷을 찍고, 여백, 크기, 정렬을 측정합니다. 해당 레이아웃 위에서 설계합니다.
- 데모 구축 — 실제로 작동하는
feat()항목으로: 클릭, 키, 종료를 포함한 동작, 라이트 + 다크, 좁은 너비. →references/add-feature.md - 녹화:
changes행 및features/<id>→review. - 인계하고 중지. 링크 + 확인할 사항. 이 항목에 대한 제품 코드는
approved상태가 될 때까지 금지. "반대하지 않으면 진행"은 승인이 아닙니다. 마감 기한 전에 승인을 받을 수 없으면, 이미 출시된 것을 사용자에게 제공하세요. 절대 미리 빌드하지 마십시오. - 결정 처리 — 모든 UI 세션 시작 시와 사용자가 리뷰했다고 말할 때:
features를 읽습니다.approved→ 7.changes→note가 요청 사항 → 3. 사용자가 승인했다고 말하지만 DB가 동의하지 않음 → 클릭이 저장되지 않음: 그렇게 말하고, 대신 설정해 줍니다. - 즉시 포팅 — 사용자는 계획을 검토하지 않습니다. 그들의 기준은 9단계입니다.
porting으로 설정.references/port-brief.md에 따라 간략히 설명. 파일 영역당 하나의 포팅 에이전트. 마이그레이션은 워크스페이스 복사본에서 실행. 라이브 데이터에서는 명시적 승인과 백업이 있을 때만 실행. - 라이브 증거와 함께 출시 (측정값, 프레임별 동작, 두 테마, 사용자의 너비):
shipped+changes행 + 확인할 사항. - 검증은 사용자의 판단 — 사용자의 동의 클릭, 또는 채팅에서 이 항목이 수락되었다고 말하는 경우(그러면 설정). 모호한 "괜찮아 보여요" → 어떤 항목인지 물어보세요. 절대 자신의 판단으로 하지 마십시오.
상태, 설정자, DB 스키마, 쓰기 → references/lifecycle.md. 브레인스토밍, 계획 작성, 서브 에이전트 주도 개발, 검증 및 브랜치 마무리와의 핸드오프 → references/superpowers-integration.md.
라이브 확인 안전
실제 데이터가 있는 라이브 앱에서: 읽기 전용으로 탐색, 정확한 레이블만 클릭, 절대 삭제/제거/편집 금지 — 데이터를 변경하는 모든 확인은 워크스페이스 복사본에서 실행.
합리화
| 생각 | 현실 |
|---|---|
| "작거나 되돌리기 쉬워요" | 크기는 기준이 아닙니다. 보거나 조작하는 것이 기준입니다. 작은 UI 변경이 배치 오류를 일으키는 곳입니다. |
| "내일 마감이에요" | 데모 라운드는 몇 분이면 됩니다. 데모에 잘못 배치된 것을 출시하면 더 많은 비용이 듭니다. 순서를 지키고, 일정을 명시하세요. |
| "스크린샷을 보여주고 반대하지 않으면 진행할게요" | 침묵은 승인이 아니며, 완성된 빌드의 스크린샷은 조작 가능한 데모가 아닙니다. |
| "올바른 위치는 기본 원칙상 명백해요" | 참조 앱 이름을 대세요. "사용자가 보는 곳"이 찾을 수 없는 스위치가 출시된 방식입니다. |
| "테스트, 리뷰, 빌드가 모두 통과했으니 완료되었어요" | 그것은 porting 완료입니다. shipped는 라이브 증거가 필요하고, verified는 사용자가 필요합니다. |
| "'괜찮아 보여요'는 수락된 의미예요" | 수락은 항목별입니다. 어떤 항목인지 물어보세요. |
| "어차피 승인할 테니 마감을 위해 미리 빌드할게요" | 승인되지 않은 코드는 낭비되는 종류입니다. 오늘 출시되는 것을 가리키고, 승인 즉시 포팅하세요. |
| "더 명확한 상태를 만들게요" | 상태는 6개뿐입니다. 페이지와 사용자가 이것들을 읽습니다. |
| "시간을 절약하기 위해 포팅과 데모를 함께 해요" | approved 항목만 제품 코드를 받습니다. |
위험 신호 — 중지
- 제품 컴포넌트를 데모가 디자인을 보여주기 전에 여는 경우.
- 명명된 참조 앱 또는 실제 UI 측정이 없는 디자인.
- 라이브 증거 없는
shipped; 사용자의 해당 항목에 대한 확인 없는verified. - 실제 데이터를 보유한 앱에서 삭제/제거/저장을 클릭하는 경우.
- 동일한 파일에 두 개의 포팅 에이전트; 라이브 데이터에서 마이그레이션 실행.