Communitygithub.com

데모 리뷰 플로우

UI의 레이아웃, 컨트롤 위치, 상호작용, 키보드 단축키, 스타일, 애니메이션 등 사용자가 보고 조작하는 모든 부분을 추가, 변경 또는 재설계할 때 사용합니다. 또한 세션이 리뷰 보드가 있는 UI 작업을 재개할 때, 또는 테스트와 코드 리뷰는 통과했지만 사용자가 UI가 잘못되었다고 계속 지적할 때도 적용됩니다.

데모 리뷰 플로우란 무엇인가요?

이 스킬은 개발자가 UI 변경 사항을 실제 제품 코드에 적용하기 전에 사용자가 직접 조작하고 승인할 수 있는 작동하는 데모를 설계하도록 안내합니다. 테스트와 코드 리뷰는 메커니즘의 정확성만 증명할 뿐, 메뉴 위치가 잘못되었거나 닫기 버튼이 깜박이거나 아이콘이 2px 내려가 있는지와 같은 미묘한 UI 문제를 발견할 수 없기 때문에, 사용자 승인 프로세스가 필수적입니다. 이 스킬은 리뷰 보드(공유 데이터베이스가 있는 Artifact 페이지)를 사용하여 각 기능을 6가지 상태(review, approved, porting, shipped, verified 등)로 추적합니다. 참조 앱 조사, 실제 UI 측정, 데모 구축, 녹화, 핸드오프, 포팅, 라이브 확인, 사용자 검증의 전체 워크플로우를 포괄하며, 모든 UI 작업이 사용자의 명시적 승인을 받은 후에만 제품 코드로 이전되도록 보장합니다. Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 사용할 수 있도록 설계되었습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/whats2000/demo-review-skills/tree/HEAD/skills/demo-review-flow

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

데모 리뷰 플로우은(는) 무엇을 하나요?

테스트와 코드 리뷰는 메커니즘을 증명합니다. 그러나 메뉴가 잘못된 위치에 있거나, 닫기 버튼이 깜박이거나, 아이콘이 2px 낮게 위치하는 것은 말해주지 않습니다. 오직 사용자만이 알 수 있습니다. 따라서 보거나 조작하는 변경 사항은 제품 코드보다 먼저 사용자가 각 기능을 승인하는 작동하는 데모로 설계되며, 사용자가 실제 앱에서 수락할 때만 종료됩니다. 리뷰 보드(공유 데이터베이스가 있는 Artifact 페이지)는 6가지 상태를 통해 모든 기능을 추적합니다.

프로젝트 구성: .claude/demo-board.md (보드 URL, 영역별 참조 앱, 확인할 너비, 라이브 앱 + 실제 데이터 보유 여부, 워크스페이스 복사 포트, 게이트 명령, 스펙 파일). 없으면 먼저 보드 생성: references/board-setup.md.

어떤 경로

  • 무언가의 모양, 위치, 또는 조작 방식을 변경 → 이 플로우. 크기나 마감 기한 예외 없음.
  • 스펙 또는 승인된 데모가 이미 정의한 동작 복원 (충돌, 잘못된 데이터, 오버플로, 회귀) → TDD로 직접 수정, 데모 불필요. 사용자에게 어떤 경로로 판단했는지 알림.
  • 출시된 보드 항목에 대해 보고된 버그 → porting으로 돌아가서 수정, 라이브 확인, shipped. 모양을 변경하는 수정 → 새로운 데모 라운드.

플로우

  1. 참조 먼저. 해당 영역에 대해 사용자가 이미 알고 있는 앱을 조회합니다(구성에 나열됨). 컨트롤 위치, 각 키, 종료를 포함한 동작을 기록합니다. 명시된 이유가 있을 때만 이탈합니다. 시뮬레이션된 사용자 설문 조사가 옵션 간 선택을 도와줍니다. 참조를 대체하지는 않습니다.
  2. 실제 UI 측정. 변경 사항이 닿는 출시된 화면을 사용자의 너비로 읽기 전용 스크린샷을 찍고, 여백, 크기, 정렬을 측정합니다. 해당 레이아웃 위에서 설계합니다.
  3. 데모 구축 — 실제로 작동하는 feat() 항목으로: 클릭, 키, 종료를 포함한 동작, 라이트 + 다크, 좁은 너비. → references/add-feature.md
  4. 녹화: changes 행 및 features/<id> → review.
  5. 인계하고 중지. 링크 + 확인할 사항. 이 항목에 대한 제품 코드는 approved 상태가 될 때까지 금지. "반대하지 않으면 진행"은 승인이 아닙니다. 마감 기한 전에 승인을 받을 수 없으면, 이미 출시된 것을 사용자에게 제공하세요. 절대 미리 빌드하지 마십시오.
  6. 결정 처리 — 모든 UI 세션 시작 시와 사용자가 리뷰했다고 말할 때: features를 읽습니다. approved → 7. changes → note가 요청 사항 → 3. 사용자가 승인했다고 말하지만 DB가 동의하지 않음 → 클릭이 저장되지 않음: 그렇게 말하고, 대신 설정해 줍니다.
  7. 즉시 포팅 — 사용자는 계획을 검토하지 않습니다. 그들의 기준은 9단계입니다. porting으로 설정. references/port-brief.md에 따라 간략히 설명. 파일 영역당 하나의 포팅 에이전트. 마이그레이션은 워크스페이스 복사본에서 실행. 라이브 데이터에서는 명시적 승인과 백업이 있을 때만 실행.
  8. 라이브 증거와 함께 출시 (측정값, 프레임별 동작, 두 테마, 사용자의 너비): shipped + changes 행 + 확인할 사항.
  9. 검증은 사용자의 판단 — 사용자의 동의 클릭, 또는 채팅에서 이 항목이 수락되었다고 말하는 경우(그러면 설정). 모호한 "괜찮아 보여요" → 어떤 항목인지 물어보세요. 절대 자신의 판단으로 하지 마십시오.

상태, 설정자, DB 스키마, 쓰기 → references/lifecycle.md. 브레인스토밍, 계획 작성, 서브 에이전트 주도 개발, 검증 및 브랜치 마무리와의 핸드오프 → references/superpowers-integration.md.

라이브 확인 안전

실제 데이터가 있는 라이브 앱에서: 읽기 전용으로 탐색, 정확한 레이블만 클릭, 절대 삭제/제거/편집 금지 — 데이터를 변경하는 모든 확인은 워크스페이스 복사본에서 실행.

합리화

생각현실
"작거나 되돌리기 쉬워요"크기는 기준이 아닙니다. 보거나 조작하는 것이 기준입니다. 작은 UI 변경이 배치 오류를 일으키는 곳입니다.
"내일 마감이에요"데모 라운드는 몇 분이면 됩니다. 데모에 잘못 배치된 것을 출시하면 더 많은 비용이 듭니다. 순서를 지키고, 일정을 명시하세요.
"스크린샷을 보여주고 반대하지 않으면 진행할게요"침묵은 승인이 아니며, 완성된 빌드의 스크린샷은 조작 가능한 데모가 아닙니다.
"올바른 위치는 기본 원칙상 명백해요"참조 앱 이름을 대세요. "사용자가 보는 곳"이 찾을 수 없는 스위치가 출시된 방식입니다.
"테스트, 리뷰, 빌드가 모두 통과했으니 완료되었어요"그것은 porting 완료입니다. shipped는 라이브 증거가 필요하고, verified는 사용자가 필요합니다.
"'괜찮아 보여요'는 수락된 의미예요"수락은 항목별입니다. 어떤 항목인지 물어보세요.
"어차피 승인할 테니 마감을 위해 미리 빌드할게요"승인되지 않은 코드는 낭비되는 종류입니다. 오늘 출시되는 것을 가리키고, 승인 즉시 포팅하세요.
"더 명확한 상태를 만들게요"상태는 6개뿐입니다. 페이지와 사용자가 이것들을 읽습니다.
"시간을 절약하기 위해 포팅과 데모를 함께 해요"approved 항목만 제품 코드를 받습니다.

위험 신호 — 중지

  • 제품 컴포넌트를 데모가 디자인을 보여주기 전에 여는 경우.
  • 명명된 참조 앱 또는 실제 UI 측정이 없는 디자인.
  • 라이브 증거 없는 shipped; 사용자의 해당 항목에 대한 확인 없는 verified.
  • 실제 데이터를 보유한 앱에서 삭제/제거/저장을 클릭하는 경우.
  • 동일한 파일에 두 개의 포팅 에이전트; 라이브 데이터에서 마이그레이션 실행.

관련 스킬