{"id":"tdd-with-agent","kind":"workflow","testedWith":[],"durationMin":20,"url":"https://opencurrent.ai/w/tdd-with-agent","title":"TDD로 에이전트 결과 확인하기","summary":"에이전트에게 테스트를 먼저 쓰게 하고 그 테스트를 통과할 때까지 구현시키면, 결과가 맞는지 사람이 코드를 다 읽지 않아도 테스트로 확인할 수 있습니다.","category":"개발","categoryId":"dev","domain":"dev","domainLabel":"개발","capabilities":[{"id":"code","label":"코드 작성"}],"topics":[{"id":"dev","label":"개발"}],"tools":["Claude Code","Codex CLI"],"whenToUse":"만들 동작을 테스트로 먼저 쓰게 하고 실패하는 것을 확인한 뒤 테스트만 커밋합니다. 그다음 테스트는 건드리지 말고 구현하게 해서 통과시키고, 마지막에 테스트가 바뀌지 않았는지 봅니다. 명령과 설정 이름은 2026년 11월 21일에 Claude Code 공식 문서로 확인했습니다.","prerequisites":["코딩 에이전트(Claude Code, Codex 등)","테스트를 돌릴 수 있는 프로젝트"],"inputs":[{"name":"feature","label":"만들 동작","description":"테스트로 정할 기능 하나","example":"장바구니 합계에 할인 쿠폰 적용","required":true}],"howToFollow":"1. 입력값(inputs)을 사용자에게 받아 프롬프트의 {{이름}} 자리에 넣을 것. 필수값이 없으면 먼저 물어볼 것.\n2. 단계를 순서대로 진행할 것. kind가 \"ai\"면 프롬프트를 실행하고, \"command\"면 사용자의 허락을 받고 명령을 실행하고, \"human\"이면 사용자에게 할 일을 안내하고 끝났는지 물을 것. tool이 있으면 그 도구·모델로 할 것.\n3. 단계에 output(결과 이름)이 있으면 그 단계 결과를 뒤 단계 프롬프트의 {{output}} 자리에 넣을 것.\n4. 단계마다 expected(기대 결과)와 check(확인 방법)로 제대로 됐는지 확인하고, 다르면 다음 단계로 넘어가지 말고 사용자에게 알릴 것. 끝나면 example.output(있으면)과 비교할 것.\n5. 검증 상태가 verified가 아니면 그 사실을 사용자에게 먼저 알릴 것. 답에 url을 출처로 밝힐 것.","steps":[{"n":1,"kind":"ai","title":"테스트 먼저","body":"만들 동작의 입력과 기대 결과를 주고 테스트만 쓰게 합니다. 구현은 아직 하지 않게 분명히 말합니다.","prompt":"{{feature}} 동작의 테스트만 먼저 써 줘. 정상·경계·오류 경우를 넣고, 구현 코드는 아직 쓰지 마.","expected":"실패하는 테스트","check":"테스트를 돌려 실패하는지 확인","tool":"Claude Code"},{"n":2,"kind":"command","title":"실패 확인과 테스트 커밋","body":"테스트가 실제로 실패하는지 보고, 테스트만 먼저 커밋해 둡니다. 나중에 테스트가 바뀌면 바로 보입니다.","prompt":"npm test; git add tests && git commit -m \"test: {{feature}} 테스트 먼저\"","expected":"테스트만 든 커밋","check":"git log에 테스트 커밋이 있는지 확인","tool":"Claude Code"},{"n":3,"kind":"ai","title":"테스트를 지키며 구현","body":"테스트는 고치지 말고 통과할 때까지 구현하게 합니다.","prompt":"테스트 파일은 고치지 말고, 모든 테스트가 통과할 때까지 구현해 줘. 끝나면 테스트 실행 결과를 보여 줘.","expected":"통과하는 구현","check":"테스트를 직접 돌려 통과하는지 확인","tool":"Claude Code"},{"n":4,"kind":"command","title":"테스트가 그대로인지 확인","body":"구현 중에 테스트가 바뀌지 않았는지 커밋과 비교합니다.","prompt":"git diff HEAD -- tests","expected":"빈 비교 결과","check":"출력이 비어 있는지 확인","tool":"Claude Code"}],"pitfalls":["테스트가 약하면 통과해도 틀릴 수 있음. 테스트 내용은 사람이 읽기","에이전트가 테스트를 건너뛰거나 기대값을 바꾸는 일이 있음. 4단계 비교를 빼먹지 않기"],"sources":[{"title":"Claude Code 문서: 모범 사례(확인할 검사를 주기)","url":"https://code.claude.com/docs/en/best-practices"},{"title":"Claude Code 문서: 자주 쓰는 작업","url":"https://code.claude.com/docs/en/common-workflows"}],"verification":{"status":"pending","label":"검수 대기","detail":"사람 확인 전","verifiedBy":0,"lastVerifiedAt":null},"quality":{"score":32,"components":{"result":0.5,"trust":0,"freshness":0.4},"explanation":"확인 없음 · 검수 대기"},"workedFor":0,"trials":{"summary":"","lastAt":null,"total":0,"worked":0,"partial":0,"failed":0,"recent":[]},"asOf":{"date":"2026-11-21T10:00:00+00:00","basis":"updated"},"updatedAt":"2026-11-21T10:00:00+00:00","goals":[{"id":"dev","title":"개발"}],"uses":0,"likes":0}