pinpoint-apm PR 전 QA 게이트
이 스킬은
.claude/agents/qa-engineer/qa-engineer.md에 정의된qa-engineer에이전트를 사용하여 실행합니다. QA 수행 시 해당 에이전트의 사고방식, 체크리스트, 출력 형식을 따르세요.
실행 시점: 커밋하거나 푸시하기 전에 반드시 실행하세요. QA 판정이 FAIL이면 문제를 해결하기 전까지 커밋하지 마세요.
PR 제출 전에 현재 변경 사항에 대한 전체 QA를 수행합니다.
1단계: 변경 사항 파악
git diff upstream/master --name-only
git diff upstream/master --stat
변경된 모든 파일을 나열하고 수정된 내용을 요약합니다.
2단계: 빌드 및 테스트
순서대로 실행하세요. 실패 시 즉시 중단하고 보고하세요. 빌드나 테스트 실패 상태에서는 커밋하지 마세요.
yarn build
yarn test
각각의 통과/실패 여부와 오류 출력을 보고합니다.
3단계: 동작 QA
변경된 각 컴포넌트, 훅, 페이지에 대해 기능 분석을 수행합니다:
3a. 해피 패스
- 정상 데이터로 기대되는 동작은 무엇인가?
- 구현이 그 기대에 부합하는가?
- 사용자 액션 → 상태 변경 → UI 업데이트 추적
3b. 엣지 케이스
변경된 UI 컴포넌트에 대해 다음을 각각 확인:
- 빈/null 데이터 상태 — API가 빈 배열이나 null을 반환할 때 무엇이 렌더링되나?
- 로딩 상태 — 스켈레톤/스피너가 표시되나? 빠른 로드에서 깜빡이지 않나?
- 오류 상태 — API 실패 / 네트워크 오류. 사용자에게 오류가 표시되나?
- 경계값 — 날짜 범위, 페이지 제한, 대용량 데이터셋
- 동시 요청 — 빠른 클릭, 여러 탭 전환
3c. 상태 무결성
- URL 파라미터가 UI 상태를 올바르게 반영 (from/to, application)
- 페이지 새로고침이 상태를 유지 (URL이 진실의 원천)
- 아톰 상태가 내비게이션 간에 누출되지 않음 (클린업 확인)
- React Query 캐시가 뮤테이션 후 오래된 데이터를 표시하지 않음
3d. 컴포넌트 상호작용
- 변경된 props가 모든 부모 컴포넌트 호출 위치를 만족함
- 이벤트 핸들러가 올바르게 발생하고 중복 액션을 생성하지 않음
- 무한 리렌더 루프 없음 (아톰 의존성 변경, 불안정한 참조)
4단계: Pinpoint 특화 확인
- application/from/to가 변경될 때 ServerMap이 여전히 렌더링됨
- 변경된 코드 근처의 스캐터 차트 상호작용(드래그 선택, 클릭)이 여전히 작동
- 트랜잭션 목록 / Inspector 내비게이션이 손상되지 않음
- 설정 기반 기능이 여전히 설정을 올바르게 확인함
5단계: 회귀 요약
다음을 나열합니다:
- 변경된 파일: (개수와 목록)
- 실행된 테스트: 통과/실패
- 빌드: 통과/실패
- 발견된 동작 이슈: (심각도와 함께 목록)
- QA 판정: ✅ PASS / ❌ FAIL / ⚠️ PASS WITH WARNINGS
FAIL 또는 PASS WITH WARNINGS인 경우, 머지 전에 필요한 구체적인 조치 사항을 나열합니다.