test-engineer

개요

test-engineer 에이전트는 테스트를 어떻게 쓸지 설계하는 역할입니다. 단위 테스트부터 통합 테스트, e2e까지 전략을 잡고, 플레이키한 테스트의 원인을 찾아 안정화합니다. 테스트를 직접 작성하는 것도 포함되지만, 주 역할은 무엇을 어떻게 테스트할지 판단하는 쪽입니다.

언제 쓰는가

• 새 기능에 맞는 테스트 전략을 처음부터 설계해야 할 때
• 플레이키한 테스트가 반복해서 실패하고 원인을 파악해야 할 때
• 현재 테스트 커버리지의 빈틈을 찾아 보강해야 할 때
• $tdd 모드에서 구현 전에 테스트를 먼저 작성해야 할 때
• verifier가 의존할 테스트 기반을 강화해야 할 때

사용 예시

"이 API 엔드포인트에 대한 테스트 전략을 세워줘"
"플레이키하게 실패하는 이 테스트 원인을 찾아줘"
"인증 모듈의 테스트 커버리지 빈틈을 파악하고 채워줘"

작업 범위

작업 프로세스

1. 대상 기능이나 모듈의 동작 경계를 파악합니다.
2. 어떤 레벨에서 어떤 케이스를 검증할지 전략을 정합니다.
3. 플레이키 테스트라면 실패 패턴을 분석해 근본 원인을 좁힙니다.
4. 테스트를 작성하거나 수정하고, 일관되게 통과하는지 확인합니다.

입력

• 테스트 대상 기능이나 모듈 설명
• 기존 테스트 코드와 실패 로그
• planner나 executor가 만든 계획이나 구현 결과
• 커버리지 리포트

출력

• 레벨별 테스트 전략 문서
• 실제 테스트 코드
• 플레이키 테스트 원인 분석 및 수정 결과
• 커버리지 개선 계획

제한 사항

• 런타임 동작의 수동 검증은 qa-tester가 담당합니다.
• 완료 증거 판정은 verifier에 맡깁니다.
• 빌드 실패처럼 테스트와 무관한 빌드 문제는 build-fixer가 처리합니다.

관련 에이전트

• verifier — test-engineer가 설계한 테스트 기반으로 완료 여부를 판정합니다.
• qa-tester — test-engineer가 다루지 않는 인터랙티브 런타임 검증을 담당합니다.
• executor — test-engineer가 작성한 테스트와 함께 구현을 진행합니다.
• debugger — 플레이키 테스트의 복잡한 근본 원인 분석을 지원합니다.