wf-web-code-reviewer은(는) 무엇을 하나요?
웹 저장소(Next.js App Router + React 19 + React Compiler + Tailwind 4 + bun, 선택적 PWA 및 비밀번호 게이트)용 리뷰어 헌장 및 인터뷰 스타일 심층 검토 패턴입니다. CRITICAL(PR 차단), WARNING(작성자에게 질문), SUGGESTION(정보 제공)이 무엇인지 정의하고, 리뷰가 어떻게 진행되는지(한 번에 하나의 질문, 결정 트리 탐색, 아키텍처 결정이 구체화될 때 ADR 기록)를 설명합니다. wf-web-code-reviewer 에이전트에 의해 로드되며, /wf-web-create-pr 명령이 이 에이전트에 위임합니다.
리뷰어 헌장
CRITICAL
- PR을 차단합니다. 해결되지 않으면 병합할 수 없습니다.
- 보안 취약점, 데이터 손실, 주요 기능 파손, 명백한 아키텍처 위반.
WARNING
- 작성자에게 질문을 던집니다. 명확히 설명하거나 수정해야 합니다.
- 잠재적인 성능 문제, 코드 냄새, 불완전한 오류 처리, 문서화되지 않은 가정.
SUGGESTION
- 정보 제공용입니다. 선택적으로 적용할 수 있습니다.
- 스타일 개선, 리팩터링 제안, 모범 사례 권장.
리뷰 진행 방식
- 한 번에 하나의 질문 - 리뷰어는 결정 트리의 현재 노드에서 질문을 하나씩 던집니다. 작성자의 답변을 기다린 후 다음 노드로 이동합니다.
- 결정 트리 탐색 - 각 질문은 결정 트리의 분기점입니다. 답변에 따라 리뷰의 깊이와 방향이 결정됩니다.
- ADR 기록 - 아키텍처 결정이 구체화될 때마다
docs/adr/디렉토리에 ADR(Architecture Decision Record)을 생성합니다.
지원 플랫폼
- GitHub Actions
- Claude Code
- Cursor
- Codex
사용 방법
wf-web-code-reviewer 에이전트가 자동으로 로드됩니다. /wf-web-create-pr 명령을 사용하여 PR을 생성하면 자동으로 이 리뷰어에게 위임됩니다.
예시 명령어
/wf-web-create-pr --title "새로운 기능 추가" --description "이 PR은..."