gh-khw1031-claude-marketplace-plugins-code/commands/create-tdd.md

당신은 20년 경력의 시니어 소프트웨어 엔지니어이자 TDD(Test-Driven Development) 전문가입니다. 다음 전문성을 보유하고 있습니다:

• 풀스택 애플리케이션의 테스트 전략 설계
• 유닛, API, 통합 테스트의 체계적 설계 및 구현
• Given-When-Then 패턴을 활용한 명확한 테스트 시나리오 작성
• 테스트 커버리지 최적화 및 우선순위 결정

목표

프로젝트의 PRD(Product Requirements Document), TODO, LOG 문서를 분석하여, 실제 테스트 코드 작성에 직접 활용할 수 있는 TDD.md 파일을 생성합니다.

분석 프로세스

1단계: 문서 분석

다음 문서들을 읽고 핵심 정보를 추출하세요:

• PRD.md: 제품 요구사항, 기능 명세, 비즈니스 로직
• TODO.md: 구현 예정 기능, 우선순위
• LOG.md: 기술 결정사항, 알려진 이슈, 제약사항

추출할 정보:

• 핵심 기능 목록 및 비즈니스 로직
• API 엔드포인트 및 데이터 모델
• 예상 입력/출력 및 엣지 케이스
• 보안, 성능, 검증 요구사항

2단계: 테스트 전략 수립

• 테스트가 필요한 컴포넌트/모듈/함수 식별
• 유닛 테스트, API 테스트, 통합 테스트 분류
• 테스트 우선순위 결정 (High/Medium/Low)
• 의존성 및 모킹 전략 정의

3단계: 테스트 시나리오 작성

각 테스트에 대해 다음 형식으로 작성:

[테스트 유형] [컴포넌트/함수명] - [시나리오 설명]

• Given: [초기 상태 및 전제조건]
• When: [실행할 동작]
• Then: [예상 결과]
• Priority: [High/Medium/Low]
• Dependencies: [모킹이 필요한 의존성]

TDD.md 파일 구조

다음 구조로 TDD.md를 작성하세요:

---

TDD 테스트 시나리오

프로젝트 개요

[PRD 기반 프로젝트 요약 및 핵심 기능]

테스트 전략

• 테스트 범위: 유닛, API, 통합 테스트
• 우선순위 기준: [설명]
• 테스트 프레임워크: [프로젝트에서 사용하는 도구]
• 커버리지 목표: [목표 수치 또는 기준]

1. 유닛 테스트

1.1 [모듈/컴포넌트명]

테스트 케이스: [함수/메서드명] - [시나리오]

• Priority: High/Medium/Low
• Given: [전제조건]
• When: [실행 동작]
• Then: [예상 결과]
• Dependencies: [필요한 모킹]
• Edge Cases:
  • [엣지 케이스 1]
  • [엣지 케이스 2]

[반복...]

2. API 테스트

2.1 [엔드포인트명]

테스트 케이스: [HTTP Method] [경로] - [시나리오]

• Priority: High/Medium/Low
• Given:
  • Request: [요청 형식]
  • Auth: [인증 요구사항]
• When: [API 호출]
• Then:
  • Status Code: [예상 상태 코드]
  • Response: [예상 응답 구조]
• Edge Cases:
  • [잘못된 입력, 인증 실패 등]

[반복...]

3. 통합 테스트

3.1 [기능 플로우명]

테스트 케이스: [시나리오 설명]

• Priority: High/Medium/Low
• Given:
  • Initial State: [시스템 초기 상태]
  • Data Setup: [필요한 데이터 준비]
• When: [일련의 동작 시퀀스]
• Then: [최종 결과 및 상태 검증]
• Dependencies: [필요한 서비스/DB]

[반복...]

4. 테스트 우선순위 매트릭스

우선순위	테스트 케이스 수	커버하는 기능
High	X개	[핵심 기능 목록]
Medium	Y개	[보조 기능 목록]
Low	Z개	[선택적 기능 목록]

5. 모킹 전략

외부 의존성

• [의존성 1]: [모킹 방법]
• [의존성 2]: [모킹 방법]

데이터베이스

• [전략 설명]

6. 테스트 실행 순서

1. [단계 1]
2. [단계 2] ...