TDD로 에이전트 결과 확인하기
에이전트에게 테스트를 먼저 쓰게 하고 그 테스트를 통과할 때까지 구현시키면, 결과가 맞는지 사람이 코드를 다 읽지 않아도 테스트로 확인할 수 있습니다.
만들 동작을 테스트로 먼저 쓰게 하고 실패하는 것을 확인한 뒤 테스트만 커밋합니다. 그다음 테스트는 건드리지 말고 구현하게 해서 통과시키고, 마지막에 테스트가 바뀌지 않았는지 봅니다. 명령과 설정 이름은 2026년 11월 21일에 Claude Code 공식 문서로 확인했습니다.
내 내용 넣기
1칸 · 필수 1칸
준비
- 코딩 에이전트(Claude Code, Codex 등)
- 테스트를 돌릴 수 있는 프로젝트
1. 테스트 먼저
만들 동작의 입력과 기대 결과를 주고 테스트만 쓰게 합니다. 구현은 아직 하지 않게 분명히 말합니다.
{{feature}} 동작의 테스트만 먼저 써 줘. 정상·경계·오류 경우를 넣고, 구현 코드는 아직 쓰지 마.결과: 실패하는 테스트
확인: 테스트를 돌려 실패하는지 확인
2. 실패 확인과 테스트 커밋
테스트가 실제로 실패하는지 보고, 테스트만 먼저 커밋해 둡니다. 나중에 테스트가 바뀌면 바로 보입니다.
npm test; git add tests && git commit -m "test: {{feature}} 테스트 먼저"결과: 테스트만 든 커밋
확인: git log에 테스트 커밋이 있는지 확인
3. 테스트를 지키며 구현
테스트는 고치지 말고 통과할 때까지 구현하게 합니다.
테스트 파일은 고치지 말고, 모든 테스트가 통과할 때까지 구현해 줘. 끝나면 테스트 실행 결과를 보여 줘.결과: 통과하는 구현
확인: 테스트를 직접 돌려 통과하는지 확인
4. 테스트가 그대로인지 확인
구현 중에 테스트가 바뀌지 않았는지 커밋과 비교합니다.
git diff HEAD -- tests결과: 빈 비교 결과
확인: 출력이 비어 있는지 확인
주의
- 테스트가 약하면 통과해도 틀릴 수 있음. 테스트 내용은 사람이 읽기
- 에이전트가 테스트를 건너뛰거나 기대값을 바꾸는 일이 있음. 4단계 비교를 빼먹지 않기
댓글