lsw417 Test Standardization Engine
다양한 프로젝트 환경에서도 일관된 테스트 품질을 유지하기 위한 표준 프레임워크입니다. 테스트 시나리오 도출부터 코드 작성, 결과 보고까지의 전 과정을 정규화하여 에이전트와 개발자 간의 신뢰를 구축합니다.
핵심 가치
- Review-First: 코드를 짜기 전 테스트 시나리오를 먼저 승인받아 의도하지 않은 테스트 누락을 방지합니다.
- Consistency: AAA 패턴과 프로젝트 내 'Golden Example'을 결합하여 이질감 없는 테스트 코드를 작성합니다.
- Permanence: 모든 테스트 결과를
docs/test-reports/에 영구 문서화하여 히스토리를 관리합니다.
수행 프로세스 (3-Phase Workflow)
Phase 1: 지능형 시나리오 추출 및 승인 (TC Extraction)
테스트 코드를 작성하기 전, 반드시 소스코드와 요구사항을 분석하여 테스트 케이스(TC) 목록을 작성합니다.
- 추출: Happy Path, 경계값, 에러 핸들링, 분기 커버리지를 고려하여 TC 매트릭스를 도출합니다.
- 승인: 도출된 리스트를
references/tc_matrix_template.md형식을 참고하여 사용자에게 제시하고 명시적인 승인을 받습니다.
Phase 2: 하이브리드 테스트 코드 작성 (Implementation)
승인된 TC를 바탕으로 코드를 구현합니다.
- AAA 패턴: Arrange, Act, Assert 구조를 엄격히 준수합니다.
- 참조(Reference) 활용: 프로젝트 내 기존 테스트 코드(
tests/,__tests__/등)를 분석하여 모킹 라이브러리 사용법, 네이밍 규칙을 그대로 따릅니다.
Phase 3: 표준 리포트 생성 및 저장 (Reporting)
테스트 수행 후 결과를 자산화합니다.
- 파일 저장:
docs/test-reports/YYYY-MM-DD_[FeatureName]_report.md경로에 저장합니다. - 분석 포함: 실패 시 단순 로그 출력이 아닌,
references/test_report_template.md를 참고하여 심층 원인 분석 및 수정 제안을 리포트에 포함합니다.
활용 가이드
- "이 기능을 위한 단위 테스트를 표준 절차에 따라 만들어줘"라고 요청하세요.
- 에이전트는 먼저 시나리오 리스트를 보여줄 것입니다. 확인 후 "진행해"라고 답하면 코드를 작성합니다.
- 테스트 완료 후 생성된 리포트 파일을 확인하여 변경 사항이나 실패 원인을 파악하세요.
참조 템플릿
- 테스트 시나리오 매트릭스 템플릿
- 표준 테스트 리포트 템플릿