Communitygithub.com

chirag127/skill-tdd

레드-그린-리팩터 TDD. 실패하는 테스트 없이 프로덕션 코드는 절대 금지. AI가 테스트를 나중에 작성하는 '치팅'을 차단합니다. 모든 기능 구현 또는 버그 수정 시 사용하세요.

skill-tdd란 무엇인가요?

이 스킬은 레드-그린-리팩터(Red-Green-Refactor) TDD 주기를 엄격하게 적용하여 AI 에이전트의 코딩 품질을 강화합니다. 핵심 규칙은 '실패하는 테스트 없이 프로덕션 코드 작성 금지'이며, 테스트를 먼저 작성하지 않고 코드를 구현하는 행위를 철저히 차단합니다. Claude Code, Codex, Cursor 등의 AI 코딩 도구에서 동작하며, 피처 구현, 버그 수정, 리팩터링 시 트리거됩니다. 스킬은 테스트와 프로덕션 코드의 분리(seam), 수직 슬라이싱(vertical slicing), 항등 테스트(tautological test) 방지 등 고급 TDD 원칙을 포함하며, 피드백 루프가 60초 미만이어야 한다는 전제 조건을 강조합니다. 코드를 먼저 작성했다면 즉시 삭제하고 테스트부터 다시 시작해야 하는 '철칙'을 통해 TDD의 본질적인 이점을 유지합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add chirag127/skill-tdd

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

tdd — 레드-그린-리팩터 (Red-Green-Refactor)

철칙 (The Iron Law)

실패하는 테스트 없이 프로덕션 코드는 절대 금지.

테스트 전에 코드를 작성했다면? 삭제하고 다시 시작하세요. 예외는 없습니다 — '참고용'으로 남겨두거나, 테스트를 작성하면서 '적응'시키거나, 그 코드를 보지 마세요. 테스트부터 완전히 새로 구현하세요.

규칙의 문자를 위반하는 것은 규칙의 정신을 위반하는 것입니다.

트리거 (Trigger)

다음과 같은 경우에 실행: "TDD this" · "red-green-refactor" · "test-first" · 새 기능 · 버그 수정 · 리팩터링 · 동작 변경. AFK 모드에서 [[afk-vs-hitl-tasks]]에 따라 테스트 인프라가 있는 작업이면 자동으로 실행됩니다.

예외 (먼저 물어볼 것): 일회용 프로토타입, 생성된 코드, 설정 파일.

"이번 한 번만 TDD를 건너뛰자"라고 생각하고 계신가요? 그만두세요. 그건 합리화입니다 — 망설여진다면 references/rationalizations.md를 참고하세요.

전제 조건 (Precondition)

테스트 루프는 60초 미만이어야 합니다 ([[feedback-loops-are-the-ceiling]] 참조). 느린 루프 → 먼저 루프를 개선하고, 느린 테스트를 피하기 위해 TDD를 건너뛰지 마세요.

CONTEXT.md와 해당 영역의 ADR을 먼저 읽으세요 — 테스트 이름과 인터페이스 용어는 프로젝트 도메인 언어와 일치해야 합니다. (도메인 용어 단계는 Matt Pocock 2026-07-08 제공)

분할점 (Seams) — 먼저 합의

분할점 (Seam) = 내부를 들여다보지 않고 동작을 관찰할 수 있는 공개 경계입니다. 테스트는 분할점에서 살아 있으며, 내부를 대상으로 하지 않습니다. 코드는 변경되지만, 분할점에 고정된 테스트는 변경에도 살아남습니다.

테스트를 작성하기 전에 사용자와 분할점을 확인하세요. 확인되지 않은 분할점에 테스트를 작성하지 마세요. 모든 엣지 케이스가 아닌, 중요한 경로와 복잡한 로직에 노력을 집중하세요. "어떤 분할점을 테스트해야 할까요?"라고 물어보세요. (분할점 개념은 Matt Pocock 2026-07-08 제공)

사이클 — 엄격한 순서

단계행동확인 사항
RED합의된 분할점에서 하나의 실패하는 테스트를 작성합니다. 가장 작은 관찰 가능 동작. 실제 코드, 불가피하지 않으면 목(mock)은 사용 금지. 명확한 이름, "그리고(and)" 사용 금지.테스트가 예상된 오류로 실패해야 합니다. 바로 통과? 기존 동작을 테스트하고 있는 것 — 테스트를 수정하세요. 오류 발생? 오류를 수정하고, 올바르게 실패할 때까지 다시 실행하세요.
GREEN테스트를 통과시키는 최소한의 코드를 작성합니다. YAGNI 옵션 없음. 테스트되지 않은 오류 처리 없음.테스트가 통과해야 합니다. 다른 테스트도 여전히 통과해야 합니다. 출력은 깨끗해야 합니다. 실패? 코드를 수정하고, 절대 테스트를 수정하지 마세요.
REFACTOR[[deep-modules-over-shallow]]에 따라 깊은 모듈을 추출합니다. 명확성을 위해 이름을 변경합니다. 리팩터에서 동작을 추가하지 마세요.계속 통과 상태를 유지해야 합니다.
LOOP다음 실패하는 테스트로 넘어갑니다. 수직 슬라이스 — 하나의 테스트 → 하나의 구현 → 반복, 각각은 이전 사이클에서 배운 내용에 반응하는 트레이서 불릿(tracer bullet)입니다. RED로 돌아갑니다.—

안티패턴 — 금지 (Locked)

  • 구현 결합 (Implementation-coupled) — 내부 협력자를 목(mock) 처리하거나, private 메서드를 테스트하거나, 사이드 채널(DB 쿼리 vs 인터페이스)을 통해 단언(assert)합니다. 징후: 동작이 변경되지 않았는데 리팩터 시 테스트가 깨집니다.
  • 항등 테스트 (Tautological) — 단언문이 예상 값을 코드와 동일한 방식으로 다시 계산합니다 (expect(add(a,b)).toBe(a+b), 수작업으로 유추한 스냅샷, 상수-자기자신-비교). 구조적으로 통과합니다. 예상 값은 독립적인 출처에서 가져와야 합니다: 알려진 올바른 리터럴, 작업 예제, 명세. (항등 테스트 개념은 Matt Pocock 2026-07-08 제공)
  • 수평 슬라이싱 (Horizontal slicing) — 모든 테스트를 먼저 작성한 후 모든 구현을 작성합니다. 상상된 동작을 검증하며, 테스트는 실제 변경에 둔감해집니다. 오직 수직 슬라이스로만 작업하세요. (수평 vs 수직 개념은 Matt Pocock 2026-07-08 제공)

안티 치트 (Anti-cheat) — 금지 (Locked)

  • 프로덕션 코드를 작성하기 전에 반드시 실패하는 테스트 출력을 확인해야 합니다.
  • 첫 번째 테스트가 통과하기 전에 여러 테스트를 작성해서는 안 됩니다.
  • 리팩터 단계를 절대 건너뛰지 마세요.
  • 사후에 테스트를 구현에 맞게 다시 작성해서는 안 됩니다.

코드 이후에 작성된 테스트는 명세를 따르는 것이 아니라 코드를 따릅니다. 이는 TDD의 목적을 무효화합니다.

사이클별 출력 형식 (Output shape per cycle)

SEAM:     <테스트 대상 공개 인터페이스>
RED:      <테스트 이름> → <예상 실패 메시지>
GREEN:    <변경된 파일, LOC 증감>
REFACTOR: <추출/이름 변경된 내용>

참고 자료 (Cross-refs)

관련 스킬