tddlisted

# TDD - Test-Driven Development ## 황금률 **실패하는 테스트 없이 프로덕션 코드 작성 금지** ## 금지 사항 | 금지 | 대신 | |------|------| | 코드 작성 후 테스트 | 테스트 작성 → 실패 확인 → 코드 작성 | | 테스트 실패 확인 생략 | 반드시 RED 상태 확인 | ## 사용법 ``` /tdd [기능 설명] /tdd 이메일 검증 함수 /tdd 사용자 생성 API ``` ## TDD 사이클 ``` RED: 실패하는 테스트 작성 GREEN: 테스트를 통과하는 최소 코드 REFACTOR: 코드 개선 (테스트 유지) (반복) ``` ## 프로세스 아래 예시는 의사코드다 — 실제 작성은 프로젝트 언어와 테스트 프레임워크 관용구를 따른다 (gtest/Catch2, go test, cargo test, xUnit/NUnit, pytest 등). ### 1단계: 인터페이스 정의 ``` // 함수 시그니처 먼저 정의 (프로젝트 언어로) ValidateEmail(email: string) -> ValidationResult { valid, error } ``` ### 2단계: 테스트 케이스 도출 - 정상 케이스 (valid email) - 에러 케이스 (invalid format) - 경계값 (empty string, very long email) ### 3단계: RED - 첫 테스트 작성 ``` test "valid email returns success": result = ValidateEmail("user@example.com") assert result.valid == true ``` ### 4단계: GREEN - 최소 구현 ``` ValidateEmail(email): return { valid: email contains "@" } ``` ### 5단계: REFACTOR - 개선 ``` ValidateEmail(email): return { valid: EMAIL_REGEX matches email } ``` ## 출력 예시 ```markdown ## TDD 세션: 이메일 검증 ### 인터페이스 ValidateEmail(email: string) -> { valid: bool, error?: string } ### 테스트 케이스 - [x] 정상 이메일 → valid: true - [ ] 빈 문자열 → valid: false, error 포함 - [ ] @ 없음 → valid: false - [ ] 도메인 없음 → valid: false ### 현재 단계 RED: "빈 문자열" 테스트 작성 중 ### 다음 작업 빈 문자열 테스트 통과하는 코드 구현 ``` ## 옵션 - `--unit`: 단위 테스트 중심 - `--integration`: 통합 테스트 포함 - `--coverage`: 커버리지 목표 설정 ## 참조 및 산출물 - 테스트 네이밍 / AAA / 경계값 / 금지 사항 기준: `references/