TDD Workflow

테스트 주도 개발 워크플로우입니다. 테스트를 먼저 작성하고, 테스트를 통과하는 코드를 구현합니다.

핵심 원칙

ALWAYS write tests first, then implement code to make tests pass.

Red-Green-Refactor 사이클

🔴 RED: 실패하는 테스트 작성
    ↓
🟢 GREEN: 테스트를 통과하는 최소한의 코드 작성
    ↓
🔵 REFACTOR: 코드 개선 (테스트는 계속 통과)
    ↓
   반복

워크플로우

Phase 1: 요구사항 분석

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

Phase 2: 인터페이스 정의 (RED 준비)

1. 입력 타입 정의
2. 출력 타입 정의
3. 에러 케이스 정의
4. 경계 조건 정의

Phase 3: 테스트 작성 (RED)

class TestSemanticSearch:
    def test_returns_relevant_results_for_valid_query(self):
        service = SemanticSearchService()
        results = service.search("crypto trading platform")
        assert len(results) > 0
        assert all(result.relevance_score > 0.5 for result in results)
    
    def test_returns_empty_for_no_matches(self):
        service = SemanticSearchService()
        results = service.search("xyz123nonexistent")
        assert results == []
    
    def test_raises_error_for_empty_query(self):
        service = SemanticSearchService()
        with pytest.raises(ValueError, match="Query cannot be empty"):
            service.search("")

Phase 4: 최소 구현 (GREEN)

테스트를 통과하는 최소한의 코드만 작성합니다.

Phase 5: 리팩토링 (REFACTOR)

테스트가 통과하는 상태에서 코드를 개선합니다. ⚠️ 리팩토링 후 반드시 테스트 재실행

Phase 6: 커버리지 확인

Line 80%+, Branch 75%+, Function 90%+ 달성을 확인합니다.

체크리스트

테스트 작성 전

• 요구사항 명확히 이해
• 입출력 타입 정의
• 경계 조건 식별
• 에러 케이스 식별

테스트 작성 시

• 실패하는 테스트 먼저 확인
• 하나의 테스트는 하나의 동작만
• 의미 있는 테스트 이름
• 적절한 assertion

구현 후

• 모든 테스트 통과
• 80%+ 커버리지
• 리팩토링 완료

상세 참조

테스트 유형별 가이드, 커버리지 기준, 모킹 가이드, 테스트 작성 패턴(BDD/AAA): Read references/testing-patterns.md in this skill directory.

문서화 (작업 완료 후 자동 실행)

작업 완료 시 auto-documenter를 호출하여 프로젝트 문서를 업데이트한다.

Completion

RED-GREEN-REFACTOR 사이클 완료 + 커버리지 목표(Line 80%+, Branch 75%+, Function 90%+) 달성.

Troubleshooting

RED 단계에서 테스트가 이미 통과함: 테스트가 실제로 동작을 검증하는지 확인. 통과하는 테스트는 검증력이 없을 수 있음. assertion을 강화하거나 테스트 재작성. REFACTOR 후 테스트 실패: 리팩토링이 동작을 변경한 것. 즉시 revert 후 더 작은 단위로 리팩토링 재시도. 커버리지 80% 미달: 테스트 누락 영역 확인 (--cov-report=term-missing). edge case/error case 테스트 추가 우선.