---

name: tdd-flow description: RED-GREEN-REFACTOR 워크플로우를 강제하는 TDD 개발 스킬 allowed-tools:

• Read
• Write
• Edit
• Bash
• Grep
• Glob

---

TDD Flow Skill

이 스킬은 ForkLore 프로젝트에서 TDD(Test-Driven Development) 워크플로우를 강제합니다.

워크플로우

1. RED 단계 - 실패하는 테스트 먼저 작성

Copy# Backend (pytest)
poetry run pytest apps/{app}/tests/test_{feature}.py -v

# Frontend (vitest)
pnpm test -- {feature}.test.tsx

반드시 테스트가 FAIL 상태임을 확인한 후 다음 단계로 진행합니다.

2. GREEN 단계 - 최소한의 구현

테스트를 통과하기 위한 최소한의 코드만 작성합니다.

• 과도한 추상화 금지
• 불필요한 기능 추가 금지
• 테스트 통과만을 목표로 함

Copy# 테스트 실행하여 PASS 확인
poetry run pytest apps/{app}/tests/test_{feature}.py -v

3. REFACTOR 단계 - 코드 개선

테스트가 통과한 상태에서 코드를 개선합니다.

• 중복 제거
• 가독성 향상
• 성능 최적화

Copy# 리팩토링 후에도 테스트 PASS 유지 확인
poetry run pytest apps/{app}/tests/test_{feature}.py -v

ForkLore 테스트 규칙

Backend

• 테스트 위치: apps/{app}/tests/
• 픽스처: @pytest.fixture, model_bakery
• 커버리지: 95% 이상 유지
• 명령어: poetry run pytest --cov=apps --cov-report=term-missing

Frontend

• 테스트 위치: __tests__/ 또는 *.test.tsx
• 도구: vitest, React Testing Library
• 명령어: pnpm test -- --run

체크리스트

• 테스트 먼저 작성했는가?
• 테스트가 실패하는 것을 확인했는가?
• 최소한의 코드로 테스트를 통과시켰는가?
• 리팩토링 후에도 테스트가 통과하는가?
• 커버리지가 95% 이상인가?