tdd-workflow

tdd-workflow 스킬 개요

tdd-workflow가 하는 일

tdd-workflow는 기능 개발, 버그 수정, 리팩터링을 위한 테스트 우선 실행 스킬입니다. 대충 짠 구현 아이디어를 결과적으로 패치하는 방식이 아니라, 단위 테스트, 통합 테스트, E2E 테스트로 검증된 코드로 옮겨 가도록 돕도록 설계되었습니다.

누가 설치하면 좋은가

앱 코드, API, UI 변경, 자동화 비중이 큰 작업에 더 엄격한 개발 루프가 필요하다면 tdd-workflow 스킬을 설치하세요. 특히 예측 가능한 커버리지, 명시적인 엣지 케이스 처리, Test Automation 작업에서 반복 가능한 작업 순서가 필요할 때 유용합니다.

이 스킬이 돋보이는 이유

tdd-workflow의 핵심 가치는 규율입니다. 테스트가 코드보다 먼저 오고, 커버리지 목표는 명확하며, 각 단계마다 근거가 필요합니다. 그래서 단순한 “테스트를 작성하라”는 프롬프트보다 더 의사결정에 도움이 됩니다. 구현으로 바로 뛰어들지 않고, 계획하고 검증하고 체크포인트를 남기도록 에이전트를 밀어주기 때문입니다.

tdd-workflow 스킬 사용 방법

설치하고 활성화하기

이 저장소에서는 tdd-workflow install 흐름을 사용하거나, Claude Code 설정이 스킬을 수동으로 관리한다면 해당 skills 경로에 추가하세요. 중요한 점은 첫 초안이 나온 뒤가 아니라, 코드를 쓰기 전에 에이전트가 이 스킬을 먼저 보게 하는 것입니다.

스킬에 맞는 작업 형태로 요청하기

tdd-workflow usage 패턴은 변경 내용, 위험 요소, 기대하는 증거를 요청에 함께 적을 때 가장 잘 작동합니다. 약한 입력: “로그인 수정.” 강한 입력: “비밀번호 재설정 검증을 추가하고, API와 UI 오류 상태를 모두 커버하되 현재 auth contract는 그대로 유지.” 두 번째처럼 쓰면 스킬이 테스트를 먼저 작성하고, 단위/통합/E2E 커버리지의 적절한 조합을 고르기에 충분한 구조를 얻습니다.

먼저 이 파일들을 읽기

먼저 SKILL.md를 읽고, 이어서 저장소의 README.md, AGENTS.md, metadata.json, 그리고 존재한다면 rules/, resources/, references/, scripts/ 폴더를 살펴보세요. 이 저장소에서는 보이는 소스 파일이 SKILL.md뿐이므로, 이를 표준 워크플로 명세로 보고 대상 프로젝트의 테스트 스택과 제약에 맞게 적용해야 합니다.

순서대로 워크플로 따르기

이 스킬로 먼저 실패할 테스트를 정의하고, 그 테스트를 통과시키는 가장 작은 코드 변경을 구현한 뒤, 다음 검증 단계를 실행하세요. 저장소가 Git 체크포인트를 지원한다면 각 TDD 단계마다 커밋을 남겨 증거 흐름이 읽기 쉽고 되돌리기 쉬운 상태를 유지하세요. 이 방식은 백엔드 로직, API 경계, 브라우저 동작이 함께 얽힌 작업에서 특히 중요합니다.

tdd-workflow 스킬 FAQ

tdd-workflow는 큰 변경에만 필요한가요?

아닙니다. tdd-workflow skill은 작은 버그 수정에도 유용합니다. 특히 버그가 미묘하거나 재발 가능성이 높을 때 효과적입니다. 반면 단순한 문구 수정이나 단계적 검증이 큰 의미가 없는 한 줄 설정 변경에는 상대적으로 가치가 낮습니다.

먼저 성숙한 테스트 스위트가 있어야 하나요?

반드시 그렇지는 않지만, 워크플로를 실제로 작동시키려면 충분한 테스트 도구는 있어야 합니다. 프로젝트에 실질적으로 쓸 수 있는 단위/통합/E2E 구성이 없다면 tdd-workflow guide는 프로세스 측면에서는 여전히 도움이 되지만, 커버리지 목표는 저장소의 실제 테스트 경계에 맞게 조정해야 할 수 있습니다.

일반 프롬프트와 무엇이 다른가요?

일반 프롬프트는 코드와 테스트를 함께 요청할 수 있습니다. 하지만 tdd-workflow는 순서와 판단 기준을 바꿉니다. 테스트가 먼저고, 커버리지 기대치가 명시되며, 검증도 테스트 유형별로 단계화됩니다. 그래서 Test Automation을 하거나 스택의 여러 계층을 넘나드는 작업에서 추측을 줄이는 데 도움이 됩니다.

초보자도 쓰기 쉬운가요?

네, 테스트 실패를 읽고 단계적으로 루프를 따라갈 수 있다면 그렇습니다. 초보자에게도 구조는 도움이 되지만, 작업 범위를 좁게 유지하고 명확한 승인 기준을 제시해야 합니다. 그렇지 않으면 유용하기보다 지나치게 엄격하게 느껴질 수 있습니다.

tdd-workflow 스킬 개선 방법

더 선명한 승인 기준을 제시하기

tdd-workflow에 가장 잘 맞는 입력은 무엇이 반드시 동작해야 하는지, 무엇이 바뀌면 안 되는지, 성공을 어떻게 확인할지를 분명히 적은 요청입니다. 입력값, 출력값, 실패 사례, 호환성 제약을 포함하세요. 예: “빈 email은 거부하고, 기존 response shape는 유지하며, 브라우저 경로와 API 오류 처리까지 커버할 것.”

적절한 테스트 조합을 요청하기

변경의 위험이 어디에 있는지 지정하면 이 스킬은 더 잘 작동합니다. 비즈니스 로직을 건드린다면 단위 테스트를 먼저 요청하세요. 서비스 경계를 넘는다면 통합 커버리지를 요구하세요. 사용자 여정이 중요하다면 E2E 체크를 추가하세요. 그래야 워크플로가 한 가지 테스트 유형에 치우쳐 실제 실패 지점을 놓치는 일을 막을 수 있습니다.

흔한 실패 모드에 주의하기

가장 흔한 문제는 테스트가 안정되기도 전에 구현을 과하게 밀어붙이는 것입니다. 또 하나는 80%+ 커버리지를 채우는 것을 끝난 일처럼 보는 태도인데, 실제로는 엣지 케이스, 경계, 오류 경로를 덮고 있는지 보여 주는 신호로 봐야 합니다. 첫 시도가 너무 넓다면 범위를 좁히고, 한 번에 하나의 시나리오씩 tdd-workflow usage 루프를 다시 돌리세요.

증거를 바탕으로 반복하기

첫 결과를 받은 뒤에는 어떤 테스트가 실패했는지, 어떤 동작이 증명되었는지, 아직 검증되지 않은 것은 무엇인지 확인하세요. 그런 다음 전면 재작성보다 가장 작은 다음 단계를 요청하는 편이 좋습니다. tdd-workflow for Test Automation에서는 보통 셀렉터를 더 정교하게 다듬고, 명시적 어서션을 추가하고, 부정 사례 커버리지를 먼저 강화한 다음 더 많은 사용자 흐름으로 넓혀 갑니다.