# Tdd Flow

> RED-GREEN-REFACTOR 워크플로우를 강제하는 TDD 개발 스킬

- Skill: `majiayu000/tdd-flow` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/tdd-flow`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/tdd-flow/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/tdd-flow

---


# TDD Flow Skill

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

## 워크플로우

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

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

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

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

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

테스트를 통과하기 위한 최소한의 코드만 작성합니다.
- 과도한 추상화 금지
- 불필요한 기능 추가 금지
- 테스트 통과만을 목표로 함

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

### 3. REFACTOR 단계 - 코드 개선

테스트가 통과한 상태에서 코드를 개선합니다.
- 중복 제거
- 가독성 향상
- 성능 최적화

```bash
# 리팩토링 후에도 테스트 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% 이상인가?