테스트 주도 개발 워크플로우

이 스킬은 모든 코드 개발이 포괄적인 테스트 커버리지와 함께 TDD 원칙을 따르도록 보장합니다.

활성화 시점

• 새 기능이나 기능성을 작성할 때
• 버그나 이슈를 수정할 때
• 기존 코드를 리팩터링할 때
• API 엔드포인트를 추가할 때
• 새 컴포넌트를 생성할 때

핵심 원칙

1. 코드보다 테스트가 먼저

항상 테스트를 먼저 작성한 후, 테스트를 통과시키는 코드를 구현합니다.

2. 커버리지 요구 사항

• 최소 80% 커버리지 (단위 + 통합 + E2E)
• 모든 엣지 케이스 커버
• 에러 시나리오 테스트
• 경계 조건 검증

3. 테스트 유형

단위 테스트

• 개별 함수 및 유틸리티
• 컴포넌트 로직
• 순수 함수
• 헬퍼 및 유틸리티

통합 테스트

• API 엔드포인트
• 데이터베이스 작업
• 서비스 상호작용
• 외부 API 호출

E2E 테스트 (Playwright)

• 핵심 사용자 플로우
• 완전한 워크플로우
• 브라우저 자동화
• UI 상호작용

TDD 워크플로우 단계

단계 1: 사용자 여정 작성

As a [role], I want to [action], so that [benefit]

Example:
As a user, I want to search for markets semantically,
so that I can find relevant markets even without exact keywords.

단계 2: 테스트 케이스 생성

각 사용자 여정에 대해 포괄적인 테스트 케이스를 작성합니다:

describe('Semantic Search', () => {
  it('returns relevant markets for query', async () => {
    // Test implementation
  })

  it('handles empty query gracefully', async () => {
    // Test edge case
  })

  it('falls back to substring search when Redis unavailable', async () => {
    // Test fallback behavior
  })

  it('sorts results by similarity score', asy…