# TDD로 에이전트 결과 확인하기
id: tdd-with-agent · 종류: 워크플로 · 상태: 검수 대기 (사람 확인 전) · 주제: 개발
주소: https://opencurrent.ai/w/tdd-with-agent
기준일: 2026-11-21 (여기서 고친 날)
도구: Claude Code, Codex CLI
걸리는 시간: 약 20분
평가 점수: 32/100 (확인 없음 · 검수 대기)

에이전트에게 테스트를 먼저 쓰게 하고 그 테스트를 통과할 때까지 구현시키면, 결과가 맞는지 사람이 코드를 다 읽지 않아도 테스트로 확인할 수 있습니다.

설명: 만들 동작을 테스트로 먼저 쓰게 하고 실패하는 것을 확인한 뒤 테스트만 커밋합니다. 그다음 테스트는 건드리지 말고 구현하게 해서 통과시키고, 마지막에 테스트가 바뀌지 않았는지 봅니다. 명령과 설정 이름은 2026년 11월 21일에 Claude Code 공식 문서로 확인했습니다.

준비물: 코딩 에이전트(Claude Code, Codex 등) · 테스트를 돌릴 수 있는 프로젝트

입력값 (프롬프트의 {{이름}}에 넣는다):
- {{feature}} 만들 동작 (필수) 예: 장바구니 합계에 할인 쿠폰 적용

단계:
1. [AI에게 · Claude Code] 테스트 먼저 — 만들 동작의 입력과 기대 결과를 주고 테스트만 쓰게 합니다. 구현은 아직 하지 않게 분명히 말합니다.
   프롬프트:
   > {{feature}} 동작의 테스트만 먼저 써 줘. 정상·경계·오류 경우를 넣고, 구현 코드는 아직 쓰지 마.
   기대 결과: 실패하는 테스트
   확인 방법: 테스트를 돌려 실패하는지 확인
2. [명령 실행 · Claude Code] 실패 확인과 테스트 커밋 — 테스트가 실제로 실패하는지 보고, 테스트만 먼저 커밋해 둡니다. 나중에 테스트가 바뀌면 바로 보입니다.
   프롬프트:
   > npm test; git add tests && git commit -m "test: {{feature}} 테스트 먼저"
   기대 결과: 테스트만 든 커밋
   확인 방법: git log에 테스트 커밋이 있는지 확인
3. [AI에게 · Claude Code] 테스트를 지키며 구현 — 테스트는 고치지 말고 통과할 때까지 구현하게 합니다.
   프롬프트:
   > 테스트 파일은 고치지 말고, 모든 테스트가 통과할 때까지 구현해 줘. 끝나면 테스트 실행 결과를 보여 줘.
   기대 결과: 통과하는 구현
   확인 방법: 테스트를 직접 돌려 통과하는지 확인
4. [명령 실행 · Claude Code] 테스트가 그대로인지 확인 — 구현 중에 테스트가 바뀌지 않았는지 커밋과 비교합니다.
   프롬프트:
   > git diff HEAD -- tests
   기대 결과: 빈 비교 결과
   확인 방법: 출력이 비어 있는지 확인

주의:
- 테스트가 약하면 통과해도 틀릴 수 있음. 테스트 내용은 사람이 읽기
- 에이전트가 테스트를 건너뛰거나 기대값을 바꾸는 일이 있음. 4단계 비교를 빼먹지 않기

출처:
- Claude Code 문서: 모범 사례(확인할 검사를 주기) https://code.claude.com/docs/en/best-practices
- Claude Code 문서: 자주 쓰는 작업 https://code.claude.com/docs/en/common-workflows