Community코딩 & 개발github.com

fnfremixer/claude-code-tdd

Claude Code에서 역할 기반 에이전트, 강제 코드 리뷰, 녹색 CI를 통해 병합 준비가 완료된 PR로 TDD를 자동화합니다.

claude-code-tdd란 무엇인가요?

이 스킬은 Claude Code를 사용한 TDD(테스트 주도 개발) 워크플로우를 자동화합니다. 역할 기반 에이전트(예: Driver, Reviewer)를 정의하여 코드 작성, 리뷰, 테스트를 체계적으로 수행하고, CI가 통과한 PR만 병합되도록 강제합니다. 주로 Claude Code 환경에서 동작하며, GitHub Actions 등을 통해 CI/CD 파이프라인과 통합됩니다. 개발자는 복잡한 설정 없이도 일관된 TDD 프로세스를 유지하고, 자동 리뷰와 녹색 CI로 인해 생산성과 코드 품질이 향상됩니다. SKILL.md 문서에 따라 에이전트 역할, 워크플로우 단계, PR 조건이 상세히 정의되어 있습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add fnfremixer/claude-code-tdd

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

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

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

문서

claude-code-tdd은(는) 무엇을 하나요?

Claude Code에서 역할 기반 에이전트, 강제 코드 리뷰, 녹색 CI를 통해 병합 준비가 완료된 PR로 TDD를 자동화합니다.

개요

이 스킬은 Claude Code 환경에서 TDD 워크플로우를 자동화합니다. 역할 기반 에이전트(Driver, Reviewer)를 사용하여 코드를 작성하고 리뷰하며, 테스트를 통과하고 CI가 성공한 경우에만 PR이 병합되도록 보장합니다.

주요 기능

  • 역할 기반 에이전트: Driver는 코드를 작성하고, Reviewer는 코드를 검토합니다. 각 역할은 명확한 책임을 가집니다.
  • 강제 코드 리뷰: 모든 PR은 병합 전에 Reviewer의 승인을 받아야 합니다.
  • 녹색 CI: CI 파이프라인이 성공해야 PR을 병합할 수 있습니다. 테스트 실패 시 자동으로 차단됩니다.
  • 자동화된 워크플로우: PR 생성, 리뷰 요청, CI 실행, 병합까지의 전체 프로세스가 자동화됩니다.

사용 방법

  1. 워크플로우 시작: claude-code-tdd 명령어를 사용하여 TDD 사이클을 시작합니다.
  2. Driver가 코드 작성: Driver 역할을 맡은 에이전트가 테스트를 먼저 작성하고, 그 다음 코드를 구현합니다.
  3. Reviewer가 코드 리뷰: Reviewer가 코드를 검토하고 승인 또는 변경 요청을 합니다.
  4. CI 실행: GitHub Actions가 자동으로 테스트를 실행합니다.
  5. PR 병합: 모든 조건이 충족되면 PR이 자동으로 병합됩니다.

지원 환경

  • 플랫폼: Claude Code
  • CI/CD: GitHub Actions
  • 언어: JavaScript, TypeScript (기본 지원, 다른 언어도 확장 가능)

설정

claude-code-tdd.json 파일을 프로젝트 루트에 생성하여 설정을 사용자 정의할 수 있습니다:

{
  "reviewer": {
    "required": true,
    "minApprovals": 1
  },
  "ci": {
    "required": true,
    "timeout": 10
  },
  "test": {
    "framework": "jest",
    "coverage": 80
  }
}

라이선스

MIT

관련 스킬