---
name: opencurrent-tdd-with-agent
description: "에이전트에게 테스트를 먼저 쓰게 하고 그 테스트를 통과할 때까지 구현시키면, 결과가 맞는지 사람이 코드를 다 읽지 않아도 테스트로 확인할 수 있습니다. 이럴 때 사용: 만들 동작을 테스트로 먼저 쓰게 하고 실패하는 것을 확인한 뒤 테스트만 커밋합니다. 그다음 테스트는 건드리지 말고 구현하게 해서 통과시키고, 마지막에 테스트가 바뀌지 않았는지 봅니다. 명령과 설정 이름은 2026년 11월 21일에 Claude Code 공식 문서로 확인했습니다. 도구: Claude Code, Codex CLI."
metadata:
  source: "https://opencurrent.ai/w/tdd-with-agent"
  opencurrent-id: "tdd-with-agent"
  verification: "pending"
  exported-at: "2026-11-21T11:18:03.245Z"
---

# TDD로 에이전트 결과 확인하기

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

> OpenCurrent에서 사람들이 다듬는 워크플로. 원문: https://opencurrent.ai/w/tdd-with-agent
> 검증 상태: 검수 대기 (사람 확인 전). 내려받은 뒤에 바뀌었을 수 있으니, 가능하면 원문이나 MCP의 get_workflow("tdd-with-agent")로 최신 상태를 확인할 것.
> 주의: 검수 대기 상태. 사용자에게 이 사실을 알리고, 결과를 함께 확인하면서 진행할 것.

## 따라 하는 방법

1. 입력값(inputs)을 사용자에게 받아 프롬프트의 {{이름}} 자리에 넣을 것. 필수값이 없으면 먼저 물어볼 것.
2. 단계를 순서대로 진행할 것. kind가 "ai"면 프롬프트를 실행하고, "command"면 사용자의 허락을 받고 명령을 실행하고, "human"이면 사용자에게 할 일을 안내하고 끝났는지 물을 것. tool이 있으면 그 도구·모델로 할 것.
3. 단계에 output(결과 이름)이 있으면 그 단계 결과를 뒤 단계 프롬프트의 {{output}} 자리에 넣을 것.
4. 단계마다 expected(기대 결과)와 check(확인 방법)로 제대로 됐는지 확인하고, 다르면 다음 단계로 넘어가지 말고 사용자에게 알릴 것. 끝나면 example.output(있으면)과 비교할 것.
5. 검증 상태가 verified가 아니면 그 사실을 사용자에게 먼저 알릴 것. 답에 url을 출처로 밝힐 것.

## 언제 쓰나

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

## 준비물

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

## 입력값

시작하기 전에 사용자에게 받아서 프롬프트의 `{{이름}}` 자리에 넣을 것.

- `{{feature}}` 만들 동작 (필수): 테스트로 정할 기능 하나
  - 예: 장바구니 합계에 할인 쿠폰 적용

## 단계

### 1. 테스트 먼저 (AI에게 · Claude Code)

만들 동작의 입력과 기대 결과를 주고 테스트만 쓰게 합니다. 구현은 아직 하지 않게 분명히 말합니다.

프롬프트:

```text
{{feature}} 동작의 테스트만 먼저 써 줘. 정상·경계·오류 경우를 넣고, 구현 코드는 아직 쓰지 마.
```

기대 결과: 실패하는 테스트

확인 방법: 테스트를 돌려 실패하는지 확인

### 2. 실패 확인과 테스트 커밋 (명령 실행 · Claude Code)

테스트가 실제로 실패하는지 보고, 테스트만 먼저 커밋해 둡니다. 나중에 테스트가 바뀌면 바로 보입니다.

프롬프트:

```text
npm test; git add tests && git commit -m "test: {{feature}} 테스트 먼저"
```

기대 결과: 테스트만 든 커밋

확인 방법: git log에 테스트 커밋이 있는지 확인

### 3. 테스트를 지키며 구현 (AI에게 · Claude Code)

테스트는 고치지 말고 통과할 때까지 구현하게 합니다.

프롬프트:

```text
테스트 파일은 고치지 말고, 모든 테스트가 통과할 때까지 구현해 줘. 끝나면 테스트 실행 결과를 보여 줘.
```

기대 결과: 통과하는 구현

확인 방법: 테스트를 직접 돌려 통과하는지 확인

### 4. 테스트가 그대로인지 확인 (명령 실행 · Claude Code)

구현 중에 테스트가 바뀌지 않았는지 커밋과 비교합니다.

프롬프트:

```text
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)

## 끝나면

결과가 좋았거나 단계가 낡았으면 https://opencurrent.ai/w/tdd-with-agent 에서 알릴 것. 다음 사람이 더 정확한 방법을 쓸 수 있도록.
