테스트 주도 개발
출력 언어
기본적으로 간체 중국어로 사용자와 소통하며, 테스트 전략, 테스트 설명 및 구현 요약도 간체 중국어로 작성합니다. 사용자가 다른 언어를 명시적으로 지정하거나 기존 문서 언어가 별도로 규정된 경우 해당 규정을 따릅니다. 코드, 명령어, 제품명 및 원문을 유지해야 하는 인용은 강제로 번역하지 않습니다.
철학
핵심 원칙: 테스트는 공개 인터페이스를 통해 행동을 검증해야 하며, 구현 세부 사항을 검증해서는 안 됩니다. 코드는 완전히 변경될 수 있지만, 테스트는 변경되지 않아야 합니다.
좋은 테스트는 통합 스타일입니다: 공개 API를 통해 실제 코드 경로를 실행합니다. 시스템이 무엇을 하는지 설명하지 어떻게 하는지는 설명하지 않습니다. 좋은 테스트는 명세서처럼 읽힙니다 — "사용자가 유효한 장바구니로 체크아웃할 수 있다"는 정확히 어떤 기능이 존재하는지 알려줍니다. 이러한 테스트는 내부 구조에 관심이 없기 때문에 리팩터링에도 살아남습니다.
나쁜 테스트는 구현에 결합되어 있습니다. 내부 협력자를 목(mock) 처리하고, 비공개 메서드를 테스트하거나, 외부 수단을 통해 검증합니다(예: 인터페이스 대신 데이터베이스를 직접 쿼리). 경고 신호: 리팩터링할 때 테스트가 깨지지만, 행동은 변경되지 않았습니다. 내부 함수 이름을 바꾸었을 때 테스트가 실패한다면, 그 테스트는 행동이 아닌 구현을 테스트하고 있는 것입니다.
예제는 tests.md를, 목킹 지침은 mocking.md를 참조하세요.
안티 패턴: 수평적 슬라이스
모든 테스트를 먼저 작성하고, 그 다음 모든 구현을 작성하지 마십시오. 이것은 "수평적 슬라이싱" — RED 단계를 "모든 테스트 작성", GREEN 단계를 "모든 코드 작성"으로 취급하는 것입니다.
이렇게 하면 쓰레기 테스트가 생성됩니다:
- 대량으로 작성된 테스트는 실제 행동이 아닌 상상된 행동을 테스트합니다
- 결국 사용자 중심 행동이 아닌 구조 (데이터 구조, 함수 시그니처)를 테스트하게 됩니다
- 테스트가 실제 변경에 둔감해져 행동이 깨져도 통과하고, 행동이 정상이어도 실패합니다
- 전조등 너머를 달리며, 구현을 이해하기 전에 테스트 구조에 확약하게 됩니다
올바른 접근법: 트레이서 불렛을 통한 수직적 슬라이스. 하나의 테스트 → 하나의 구현 → 반복. 각 테스트는 이전 주기에서 배운 내용에 응답합니다. 방금 코드를 작성했기 때문에 어떤 행동이 중요한지, 어떻게 검증할지 정확히 알고 있습니다.
잘못된 방법 (수평적):
RED: test1, test2, test3, test4, test5
GREEN: impl1, impl2, impl3, impl4, impl5
올바른 방법 (수직적):
RED→GREEN: test1→impl1
RED→GREEN: test2→impl2
RED→GREEN: test3→impl3
...
워크플로우
1. 계획
코드베이스를 탐색할 때 CONTEXT.md (존재하는 경우)를 읽어 테스트 이름과 인터페이스 용어가 프로젝트의 도메인 언어와 일치하도록 하고, 작업 중인 영역의 ADR을 존중합니다.
코드를 작성하기 전에:
- 사용자와 필요한 인터페이스 변경 사항 확인
- 사용자와 테스트할 행동 확인 (우선순위 설정)
- 인터페이스 경계가 불명확할 때 코드베이스 설계 원칙을 사용하여 깊은 모듈(deep module) 기회 식별. 사용자가 명시적으로 요청하지 않는 한 다른 스킬을 자동으로 호출하지 마십시오.
- 테스트할 행동 목록 작성 (구현 단계 아님)
- 계획에 대한 사용자 승인 받기
질문: "공개 인터페이스는 어떻게 되어야 합니까? 어떤 행동이 가장 중요합니까?"
모든 것을 테스트할 수는 없습니다. 어떤 행동이 가장 중요한지 사용자와 정확히 확인하십시오. 테스트 노력을 모든 가능한 엣지 케이스가 아닌 중요한 경로와 복잡한 로직에 집중하십시오.
2. 트레이서 불렛
시스템에 관한 한 가지를 확인하는 하나의 테스트를 작성합니다:
RED: 첫 번째 행동에 대한 테스트 작성 → 테스트 실패
GREEN: 통과할 수 있는 최소 코드 작성 → 테스트 통과
이것이 트레이서 불렛입니다 — 경로가 종단 간 작동함을 증명합니다.
3. 증분적 루프
각 나머지 행동에 대해:
RED: 다음 테스트 작성 → 실패
GREEN: 통과할 수 있는 최소 코드 → 통과
규칙:
- 한 번에 하나의 테스트
- 현재 테스트를 통과할 만큼만 코드 작성
- 미래의 테스트를 예측하지 않음
- 테스트를 관찰 가능한 행동에 집중
4. 리팩터
모든 테스트가 통과한 후, 리팩터 후보를 찾습니다:
- 중복 추출
- 모듈 깊게 만들기 (복잡성을 단순한 인터페이스 뒤로 이동)
- 자연스러운 경우 SOLID 원칙 적용
- 새 코드가 기존 코드에 대해 무엇을 드러내는지 고려
- 각 리팩터 단계 후 테스트 실행
RED 상태에서는 절대 리팩터하지 마십시오. 먼저 GREEN에 도달하십시오.
주기별 체크리스트
[ ] 테스트는 행동을 설명하며, 구현을 설명하지 않음
[ ] 테스트는 공개 인터페이스만 사용
[ ] 테스트는 내부 리팩터에서도 살아남음
[ ] 코드는 이 테스트에 최소화됨
[ ] 추측성 기능 추가 없음