완벽한 바이브 (Immaculate Vibes)
바이브 코딩된 코드베이스를 검토해 달라는 요청을 받았습니다. 발견된 문제를 수정하는 것이 아니라 권장 사항만 제시하면 됩니다.
프로세스
전체 프로세스는 다음과 같습니다:
- 사용 가능한 모든 제품 문서를 수집합니다.
- 사용자에게 질문하여 애플리케이션에 대한 이해를 깊게 합니다.
- 품질 기둥을 기준으로 코드를 검토합니다.
- 결과를 바탕으로 보고서를 작성합니다.
품질 기둥
고품질 소프트웨어를 작성하기 위한 기둥입니다. 중요도 순으로 나열되어 있으며, 이 관점을 통해 프로젝트를 바라보십시오.
- 보안(Security) - 인증, 권한, 데이터 노출 및 안전하지 않은 브라우저 동작.
- 신뢰성(Reliability) - 중요 플로우, 라우트 상태, 단언(assertion), 콘솔 오류 및 손상된 상태.
- 성능(Performance) - 로드 동작, 응답성, 비용이 많이 드는 리소스 및 사용자에게 보이는 지연 시간.
- UI/UX - 탐색, 명확성, 유효성 검사, 콘텐츠 기대치 및 시각적 일관성.
- 접근성(Accessibility) - 키보드 접근, 의미론(semantics), 레이블, ARIA, 대비 및 보조 기술 신호.
상세 프로세스
1. 사용 가능한 제품 문서 수집
이 단계에서는 사용 가능한 제품 문서를 찾습니다. 이는 검토의 기초가 되므로 품질 기둥과 관련된 모든 것을 찾으십시오.
일반적으로 찾을 수 있는 위치:
- PRODUCT.md
- PRD.md
- README.md
- docs/
2. 사용자에게 질문하기
제품 문서가 불완전하거나 현재 애플리케이션 상태와 동기화되지 않았을 수 있습니다. 프로젝트와 그 요구 사항에 대한 이해를 깊게 하는 데 도움이 되는 질문을 사용자에게 하십시오. 가능하면 질문 도구를 사용하고, 그렇지 않으면 사용자와 채팅하십시오.
질문 예시:
- 이 애플리케이션에 누가 접근해야 합니까?
- 지속적인 유지보수 계획은 무엇입니까?
- 이 애플리케이션을 어떻게 모니터링하고 성능과 신뢰성을 검증할 예정입니까?
- 이 애플리케이션은 어디에 호스팅될 예정입니까?
3. 코드 검토
수집한 정보를 바탕으로 각 품질 기둥에 대해 코드를 검토할 서브 에이전트를 시작하십시오. 컨텍스트 오염을 방지하기 위해 서로 분리하여 유지하십시오. 각 서브 에이전트는 자신의 품질 기둥을 기준으로 문제를 찾고 Go/No-Go 평가를 제공하는 임무를 수행합니다.
각 이슈는:
- 구체적이고 실행 가능한 이슈여야 합니다.
- 이슈의 영향 평가를 포함해야 합니다.
- 각 이슈에 다음 영향 수준 중 하나를 할당하십시오: Showstopper(쇼스토퍼), Critical(심각), Moderate(보통), Nice to have(있으면 좋음)
- 이슈의 명확한 설명과 관련 파일 이름 및 줄 번호(있는 경우)를 포함해야 합니다.
- 해결 방안에 대한 권장 사항을 제공해야 합니다.
4. 보고서 작성
모든 서브 에이전트의 결과를 수집하여 상세한 HTML 기반 보고서를 만들고 채팅에 높은 수준의 요약을 제공하십시오. 사용자가 검토할 수 있도록 브라우저에서 HTML 보고서를 여십시오.
보고서의 주요 특징:
- Go/No-Go 권장 사항
- 요구 사항: 제품에 대한 높은 수준의 요약과 핵심 요구 사항
- 이슈: 영향 수준이 가장 심각한 것부터 가장 덜 심각한 순서로 정렬된 발견된 이슈 목록
- 기타 정보: 검토자가 알아야 할 다른 중요한 발견 사항
보고서 예시:
권장 사항: No-go(진행 불가)
Fourgrounds 커피 랭커는 Fourgrounds 커피숍 고객이 자신이 가장 좋아하는 커피 음료를 순위 매길 수 있는 공개 애플리케이션입니다.
핵심 요구 사항:
- 사용자에게 Fourgrounds에서 현재 제공되는 음료 목록이 표시되어야 합니다.
- 사용자는 음료를 끌어서 놓아 원하는 순위로 재정렬할 수 있어야 합니다.
- 사용자는 자신의 순위를 제출하고 선택한 무료 베이커리 품목에 대한 보상을 받을 수 있어야 합니다.
- 사용자는 순위를 한 번만 제출할 수 있어야 합니다.
이슈:
사용자가 목요일에 여러 번 제출할 수 있습니다.
영향: CRITICAL(심각) - 사용자가 여러 개의 무료 보상을 축적할 수 있습니다.
date.js 42번 줄의 날짜 파싱 오류로 인해 처리되지 않은 예외가 발생하면 check-reward.js 16번 줄에서 이전 제출 여부 확인이 건너뛸 수 있습니다.
권장 사항: 기본 제공 날짜 파서를 사용하고 예외가 애플리케이션의 다른 영역에 영향을 미치지 않도록 날짜 파싱을 try/catch로 감싸십시오.
기타 정보:
coffee-products.json파일은 매일 생성됩니다. 만약 낮에 제품이 변경되면 이 파일이 최신 상태가 아닐 수 있습니다. 순위의 외부 소비자는 제품의 존재 여부를 확인해야 합니다.