---
name: vitest-helper
description: Vitest 기반 테스트 코드 작성을 표준화하고, 테스트 품질과 코드 안정성을 높이기 위한 헬퍼 및 가이드 모음
---

# Vitest Helper

Vitest Helper는 **Vitest를 활용한 테스트 코드 작성 역량을 팀 내에 정착시키기 위한 헬퍼 및 가이드 컬렉션**입니다.  
테스트 코드를 작업의 마무리 단계가 아닌, **개발 프로세스의 필수 요소**로 만드는 것을 목표로 합니다.

---

## 목적

- 테스트 코드 작성의 진입 장벽 감소
- 일관된 테스트 작성 패턴 제공
- 기능 완료 시 테스트 코드 작성을 통한 안정성 확보
- 리팩토링 및 기능 확장 시 회귀 버그 방지

---

## 대상

- Vitest를 사용하는 프론트엔드 / 백엔드 프로젝트
- 테스트 코드 작성 기준이 필요한 팀 또는 개인
- 테스트 문화 정착을 목표로 하는 개발 환경

---

## 핵심 원칙

- 모든 신규 기능은 테스트 코드 작성 후 완료로 간주
- 테스트는 구현이 아닌 **행동(Behavior)** 을 검증
- 테스트는 읽기 쉽고 의도가 명확해야 함
- 테스트가 어려운 코드는 구조 개선의 신호로 인식

---

## 제공 기능

### 1. 테스트 작성 가이드

- Given / When / Then 패턴 기반 예제
- 명확한 테스트 네이밍 규칙
- Unit / Integration 테스트 기준 정의

### 2. Vitest Helper Utilities

- 공통 Mock / Spy 헬퍼 제공
- 반복되는 테스트 설정 추상화
- 비동기 테스트 유틸 함수 제공

### 3. 테스트 품질 기준

- 정상 / 예외 케이스 테스트 기준
- 핵심 비즈니스 로직 커버리지 가이드
- Definition of Done 기반 체크리스트

---

## 예제

더 자세한 예제는 `references/` 디렉토리를 참고하세요:

- `component-test.md` - 기본 컴포넌트 테스트
- `hook-test.md` - 커스텀 훅 테스트
- `util-test.md` - 유틸리티 테스트