tdd

TechSpec의 테스트 케이스 기반으로 데이터 모델(interface), Usecase, Client Component를 설계

spec/design/issues 기반으로 Linear 이슈를 batch-tasks.yaml로 변환하고 workflow:batch에 위임하여 Red→Green→Refactor 전체 워크플로우를 병렬로 처리. 기본값은 자율 실행 모드(auto). --manual 옵션으로 각 phase 사이에 인간 리뷰를 받는 수동 모드로 전환.

서비스 폴더의 테스트 커버리지를 분석하고, 개선 대상 1건을 찾아 테스트를 작성한 뒤 Draft PR을 생성합니다.

TechSpec과 Design 문서를 기반으로 Linear에 blocker/related issue를 분류하여 생성

Linear 프로젝트 또는 이슈에 FE TechSpec 문서를 생성하고 테스트 케이스까지 작성

버그 수정이나 간단한 기능 추가를 위한 경량 TDD 워크플로우. 기본값은 자율 실행(auto). --manual 옵션으로 각 phase마다 인간 리뷰를 받는 수동 모드 전환.

주어진 요구사항을 이해하고, tdd:* command로 생성된 문서들에 잘 반영되어 있는지 체크하고 누락분을 보고/반영

TDD Design Phase 전문 agent. TechSpec의 Given/When/Then TC를 분석하여 데이터 모델(interface), Usecase, Component Tree, Visual Contract를 설계한다. tdd:design에서 설계 위임 시 사용.

TDD Gap Analysis 전문 agent. 요구사항을 TechSpec/Design/Issues/Implementation 4개 레이어와 대조하여 MISSING/OUTDATED/CONFLICT를 판정하고 액션을 제안한다. tdd:sync에서 갭 분석 위임 시 사용.

TDD Green Phase 전문 agent. 실패하는 테스트를 통과시키는 최소한의 코드만 작성하고 커밋한다. tdd:start, tdd:implement 등에서 Green phase 위임 시 사용.

TDD Integration QA 전문 agent. TechSpec의 AC와 Given/When/Then TC를 평가기준으로 도출하고, ralph-loop으로 통합된 코드가 실제로 동작하는지 반복 검증+수정한다. tdd:implement에서 QA phase 위임 시 사용.

TDD Issue Planning 전문 agent. TechSpec과 Design 문서를 분석하여 Blocker/Related issue를 분류하고, issue description 템플릿을 생성한다. tdd:issues에서 issue 분류/생성 위임 시 사용.

TDD 경량 분석/설계 agent. 문제 분석(analyze 모드)과 TC/접근법 설계(design 모드)를 수행한다. tdd:start의 Phase 2에서 위임받아 동작.

TDD Red Phase 전문 agent. Given/When/Then TC를 실패하는 테스트 코드로 변환하고 커밋한다. tdd:start, tdd:implement 등에서 Red phase 위임 시 사용.

TDD Refactor Phase 전문 agent. 코드 품질 개선, pre-commit 체크, Draft PR 생성까지 처리한다. tdd:start, tdd:implement 등에서 Refactor phase 위임 시 사용.

TDD 산출물 독립 평가 agent. 생성 에이전트와 분리된 컨텍스트에서 산출물을 회의적으로 채점한다. 자가 평가의 편향(자기 작업을 칭찬하는 경향)을 제거하기 위해 도입.

TDD 프로젝트 컨텍스트 수집 agent. 테스트 프레임워크, 린터, 기존 테스트 패턴을 탐색하고 compact summary를 반환한다. tdd:start의 Phase 1에서 위임받아 동작.

TDD Visual Verification 전문 agent. Figma 디자인과 구현을 비교하여 매칭시킨다. Presentational 컴포넌트 + Figma URL이 있는 경우에만 실행. tdd:start, tdd:implement 등에서 Visual phase 위임 시 사용.

BE TechSpec 문서 작성 템플릿과 패턴. 백엔드 프로젝트의 기술 명세서를 작성할 때 참조. Use when: BE TechSpec 작성, API 설계 문서 생성, Given/When/Then 테스트 케이스 정의, DB 스키마 설계, 서비스 아키텍처 설계 문서 작성 시 사용.

Entity Object(companion object) 패턴. Entity interface와 같은 이름의 const 객체에 도메인 로직 함수를 그룹화. Use when: TDD Refactor 단계에서 반복되는 도메인 로직을 정리할 때, Entity 구현 시 도메인 로직 코드화, UI/API/테스트에서 동일 로직 재사용이 필요할 때.

FE TechSpec 문서 작성 템플릿과 패턴. Linear 프로젝트의 기술 명세서를 작성할 때 참조. Use when: TechSpec 작성, 기술 명세서 생성, Given/When/Then 테스트 케이스 정의, Acceptance Criteria 작성, Solution 설계 문서 작성 시 사용.

TDD 산출물 평가 루브릭 정의. 각 단계별 채점 항목, 가중치, 방법을 정의한다. 실제 평가는 tdd-reviewer agent가 별도 컨텍스트에서 수행한다.

FE/BE TechSpec 공통 작성 가이드. Summary, Solution, AC, FR(GWT), Verification 등 공통 섹션의 작성 규칙. Use when: TechSpec 작성, 기술 명세서 생성, Acceptance Criteria 작성 시 공통 규칙 참조. FE 전용 가이드는 `fe-techspec`, BE 전용 가이드는 `be-techspec` 스킬 참조.

테스트 케이스 설계 규칙: 중복 방지, 경계 조건, Given/When/Then 작성, assertion 품질. Use when: 테스트 케이스 작성, test case design, 테스트 설계, Given/When/Then 작성, 테스트 코드 리뷰 시 중복 케이스 판단.

테스트 파일 위치 컨벤션 (Co-location / Flat). Use when: 테스트 파일 생성, test file creation, 테스트 파일 위치 결정, 새 테스트 추가, __tests__ 디렉토리 여부 판단.