테스트 주도 개발 워크플로우
이 스킬은 모든 코드 개발이 포괄적인 테스트 커버리지와 함께 TDD 원칙을 따르도록 보장합니다.
활성화 시점
- 새 기능이나 기능성을 작성할 때
- 버그나 이슈를 수정할 때
- 기존 코드를 리팩터링할 때
- API 엔드포인트를 추가할 때
- 새 컴포넌트를 생성할 때
핵심 원칙
1. 코드보다 테스트가 먼저
항상 테스트를 먼저 작성한 후, 테스트를 통과시키는 코드를 구현합니다.
2. 커버리지 요구 사항
- 최소 80% 커버리지 (단위 + 통합 + E2E)
- 모든 엣지 케이스 커버
- 에러 시나리오 테스트
- 경계 조건 검증
3. 테스트 유형
단위 테스트
- 개별 함수 및 유틸리티
- 컴포넌트 로직
- 순수 함수
- 헬퍼 및 유틸리티
통합 테스트
- API 엔드포인트
- 데이터베이스 작업
- 서비스 상호작용
- 외부 API 호출
E2E 테스트 (Playwright)
- 핵심 사용자 플로우
- 완전한 워크플로우
- 브라우저 자동화
- UI 상호작용
TDD 워크플로우 단계
단계 1: 사용자 여정 작성
단계 2: 테스트 케이스 생성
각 사용자 여정에 대해 포괄적인 테스트 케이스를 작성합니다:
단계 3: 테스트 실행 (실패해야 함)
단계 4: 코드 구현
테스트를 통과시키기 위한 최소한의 코드를 작성합니다:
단계 5: 테스트 재실행
단계 6: 리팩터링
테스트가 통과하는 상태를 유지하면서 코드 품질을 개선합니다:
- 중복 제거
- 네이밍 개선
- 성능 최적화
- 가독성 향상
단계 7: 커버리지 확인
테스트 패턴
단위 테스트 패턴 (Jest/Vitest)
API 통합 테스트 패턴
E2E 테스트 패턴 (Playwright)
테스트 파일 구성
외부 서비스 모킹
Supabase Mock
Redis Mock
OpenAI Mock
테스트 커버리지 검증
커버리지 리포트 실행
커버리지 임계값
흔한 테스트 실수
잘못된 예: 구현 세부사항 테스트
올바른 예: 사용자에게 보이는 동작 테스트
잘못된 예: 취약한 셀렉터
올바른 예: 시맨틱 셀렉터
잘못된 예: 테스트 격리 없음
올바른 예: 독립적인 테스트
지속적 테스트
개발 중 Watch 모드
Pre-Commit Hook
CI/CD 통합
모범 사례
- 테스트 먼저 작성 - 항상 TDD
- 테스트당 하나의 Assert - 단일 동작에 집중
- 설명적인 테스트 이름 - 무엇을 테스트하는지 설명
- Arrange-Act-Assert - 명확한 테스트 구조
- 외부 의존성 모킹 - 단위 테스트 격리
- 엣지 케이스 테스트 - null, undefined, 빈 값, 큰 값
- 에러 경로 테스트 - 정상 경로만이 아닌
- 테스트 속도 유지 - 단위 테스트 각 50ms 미만
- 테스트 후 정리 - 부작용 없음
- 커버리지 리포트 검토 - 누락 부분 식별
성공 지표
- 80% 이상의 코드 커버리지 달성
- 모든 테스트 통과 (그린)
- 건너뛴 테스트나 비활성화된 테스트 없음
- 빠른 테스트 실행 (단위 테스트 30초 미만)
- E2E 테스트가 핵심 사용자 플로우를 커버
- 테스트가 프로덕션 이전에 버그를 포착
기억하세요: 테스트는 선택 사항이 아닙니다. 테스트는 자신감 있는 리팩터링, 빠른 개발, 그리고 프로덕션 안정성을 가능하게 하는 안전망입니다.


