Tdd Guardian

TDD Guardian v2.0 - Test-Driven Development Enforcer

Proactive TDD Enforcer - 테스트 작업 시 자동으로 TDD 원칙 적용

자동 발동 조건

이 스킬은 다음 상황에서 자동으로 활성화됩니다:

Auto_Trigger_Conditions:
  File_Patterns:
    - "*.test.ts, *.test.tsx, *.test.js"
    - "*.spec.ts, *.spec.tsx, *.spec.js"
    - "__tests__/​**, test/​**, tests/​**"
    - "*_test.py, test_*.py"           # Python
    - "*_test.go"                       # Go
    - "*Test.java, *Spec.java"          # Java

  Keywords_KO:
    - "테스트 작성, 테스트 만들어, 테스트 추가"
    - "단위 테스트, 통합 테스트, E2E 테스트"
    - "TDD, 테스트 주도, 테스트 먼저"
    - "커버리지, 테스트 커버리지"
    - "테스트 코드, 테스트 케이스"
    - "mock, 모킹, 스텁"

  Keywords_EN:
    - "write test, create test, add test"
    - "unit test, integration test, e2e test"
    - "TDD, test driven, test first"
    - "coverage, test coverage"

  Code_Patterns:
    - "describe(, it(, test(, expect("
    - "jest., vitest., pytest"
    - "beforeEach, afterEach, beforeAll"

선택적 문서 로드 전략

전체 문서를 로드하지 않습니다! 상황에 따라 필요한 문서만 로드:

Document_Loading_Strategy:
  Step_1_Detect_Framework:
    - 파일 확장자, import 문, 설정 파일로 테스트 프레임워크 감지
    - 불명확하면 package.json의 devDependencies 확인

  Step_2_Load_Required_Docs:
    Universal_Always_Load:
      - "core/​tdd-workflow.md"       # TDD 3단계 사이클 (항상)
      - "core/​real-assertions.md"    # Real Assertion 규칙 (항상)

    Framework_Specific_Load:
      Jest: "frameworks/​jest.md"           # Jest 설정, 매처, 모킹
      Vitest: "frameworks/​vitest.md"       # Vitest 설정, 매처
      Mocha: "frameworks/​mocha.md"         # Mocha + Chai
      PyTest: "frameworks/​pytest.md"       # Python PyTest
      GoTest: "frameworks/​gotest.md"       # Go testing package
      RSpec: "frameworks/​rspec.md"         # Ruby RSpec
      JUnit: "frameworks/​junit.md"         # Java JUnit5
      XCTest: "frameworks/​xctest.md"       # Swift XCTest

    Context_Specific_Load:
      Unit_Test: "templates/​unit-test.md"
      Integration_Test: "templates/​integration-test.md"
      React_Test: "templates/​react-test.md"
      Fake_Detection: "patterns/​fake-test-detector.md"
      Coverage_Check: "core/​coverage-thresholds.md"

  Quick_Reference:
    Checklist: "quick-reference/​checklist.md"
    Anti_Patterns: "quick-reference/​anti-patterns.md"

2025 테스트 프레임워크 선택 가이드

Framework_Comparison:
  Vitest:
    권장_상황: "새 프로젝트, Vite 기반"
    장점:
      - "Jest보다 30-70% 빠름"
      - "ESM 네이티브 지원"
      - "설정 없이 바로 사용 (zero-config)"
      - "Jest 호환 API (jest.* → vi.*)"
      - "브라우저 UI 디버깅"
    메모리: "Jest 1.2GB vs Vitest 800MB (50K 라인 기준)"
    마이그레이션: "85-90% Jest 테스트 수정 없이 작동"

  Jest:
    권장_상황: "기존 프로젝트, React Native"
    장점:
      - "안정적, 10년+ 커뮤니티"
      - "레퍼런스/튜토리얼 풍부"
      - "스냅샷 테스팅 원조"
    주의: "ESM 설정 복잡, 싱글 스레드 기본"

  선택_기준:
    새_프로젝트: "Vitest 권장"
    기존_Jest_프로젝트: "유지 (마이그레이션 비용 고려)"
    React_Native: "Jest 필수"
    Vite_프로젝트: "Vitest 필수"

Quick Reference

5 Core Principles

1. Test First: "코드 작성 전 반드시 실패하는 테스트부터"
2. Real Assertions: "toBeDefined/​toBeTruthy 단독 사용 금지"
3. Edge Coverage: "Happy + Error + Boundary + Async 필수"
4. No Fake Tests: "15+ 패턴의 Fake Test 탐지 및 거부"
5. Coverage Gate: "80% line, 70% branch 미달 시 진행 금지"

Instant Checklist

## 테스트 작성 전 체크
- [ ] 요구사항에서 테스트 케이스 도출했는가?
- [ ] Happy/​Error/​Boundary/​Async 케이스 포함했는가?

## 테스트 작성 후 체크
- [ ] 모든 assertion이 구체적 값을 검증하는가?
- [ ] toBeDefined/​toBeTruthy 단독 사용 없는가?
- [ ] 테스트 제목과 내용이 일치하는가?
- [ ] Mock이 과도하지 않은가?
- [ ] Edge case가 포함되었는가?

## 최종 검증
- [ ] 모든 테스트 통과?
- [ ] Line coverage >= 80%?
- [ ] Branch coverage >= 70%?

문서 구조

tdd-guardian/
├── SKILL.md                          # 이 파일 (라우터)
├── core/
│   ├── tdd-workflow.md               # Red-Green-Refactor 사이클
│   ├── real-assertions.md            # Real Assertion 규칙
│   ├── edge-coverage.md              # Edge Case 커버리지
│   └── coverage-thresholds.md        # 커버리지 임계값
├── frameworks/
│   ├── jest.md                       # Jest 설정, 매처, 모킹
│   ├── vitest.md                     # Vitest 설정, 매처
│   ├── pytest.md                     # Python PyTest
│   ├── gotest.md                     # Go testing package
│   └── junit.md                      # Java JUnit5
├── templates/
│   ├── unit-test.md                  # NestJS Service/​Controller 템플릿
│   ├── integration-test.md           # E2E 테스트 템플릿
│   └── react-test.md                 # React Component/​Hook 템플릿
├── patterns/
│   ├── fake-test-detector.md         # 15+ Fake Test 패턴
│   └── mock-guidelines.md            # Mock 사용 가이드
└── quick-reference/
    ├── checklist.md                  # 빠른 체크리스트
    └── anti-patterns.md              # 20+ Anti-Pattern

사용 방법

1. 자동 발동 (Proactive)

테스트 파일 작업 시 자동으로 원칙 적용됨

2. 명시적 호출

"이 테스트 TDD 원칙으로 리뷰해줘"
"Fake test 패턴 검사해줘"
"커버리지 80% 확인해줘"

3. 템플릿 요청

"NestJS Service 단위 테스트 템플릿"
"React Hook 테스트 템플릿"
"E2E 테스트 템플릿"

Version: 2.0.0 Quality Target: 95% Related Skills: clean-code-mastery, code-reviewer