| name | benchmark |
| description | 성능 기준선을 측정하고, PR 전후 회귀를 감지하며, 스택 대안을 비교할 때 사용하는 스킬입니다. |
| origin | ECC |
Benchmark — 성능 기준선 및 회귀 탐지
사용 시점
- PR 전후 성능 영향을 측정할 때
- 프로젝트의 성능 기준선을 세팅할 때
- 사용자가 "느린 것 같다"고 말할 때
- 출시 전에 성능 목표 충족 여부를 확인할 때
- 현재 스택과 대안을 비교할 때
동작 방식
모드 1: 페이지 성능
브라우저 MCP로 실제 브라우저 메트릭을 측정합니다.
1. 대상 URL마다 이동
2. Core Web Vitals 측정
- LCP < 2.5s 목표
- CLS < 0.1 목표
- INP < 200ms 목표
- FCP < 1.8s 목표
- TTFB < 800ms 목표
3. 리소스 크기 측정
- 전체 페이지 크기 < 1MB 목표
- JS 번들 < 200KB gzipped 목표
- CSS 크기
- 이미지 용량
- 서드파티 스크립트 용량
4. 네트워크 요청 수 집계
5. 렌더 차단 리소스 확인
모드 2: API 성능
API 엔드포인트를 벤치마크합니다.
1. 각 엔드포인트를 100회 호출
2. p50, p95, p99 지연 측정
3. 응답 크기, 상태 코드 추적
4. 동시 요청 10개 부하 테스트
5. SLA 목표와 비교
모드 3: 빌드 성능
개발 피드백 루프를 측정합니다.
1. 콜드 빌드 시간
2. 핫 리로드 시간(HMR)
3. 테스트 스위트 실행 시간
4. TypeScript 검사 시간
5. Lint 시간
6. Docker 빌드 시간
모드 4: 변경 전후 비교
변경 전후를 돌려 영향도를 측정합니다.
/benchmark baseline
# ... 변경 수행 ...
/benchmark compare
출력 예시:
| Metric | Before | After | Delta | Verdict |
|--------|--------|-------|-------|---------|
| LCP | 1.2s | 1.4s | +200ms | WARNING: WARN |
| Bundle | 180KB | 175KB | -5KB | ✓ BETTER |
| Build | 12s | 14s | +2s | WARNING: WARN |
출력
기준선은 .ecc/benchmarks/ 아래 JSON으로 저장합니다. Git 추적을 통해 팀이 기준선을 공유합니다.
연동
- CI: 모든 PR에서
/benchmark compare 실행
/canary-watch와 함께 배포 후 모니터링/browser-qa와 함께 출하 전 전체 체크리스트 구성
