완료된 작업 테스트하기

변경 구현이 끝나면 자동화 테스트를 더 추가해야 하는지, 어떤 BMad 경로로 만들지 결정하세요. 내장 스킬인 bmad-qa-generate-e2e-tests는 이미 구현된 코드에 API 및 E2E 테스트를 생성합니다. 테스트 전략, 위험 기반 계획 또는 출시 게이트가 필요하다면 테스트 설계자(Test Architect, TEA) 모듈을 설치하세요. 전체 실행 과정은 bmad-qa-generate-e2e-tests 실행하기에서 확인할 수 있습니다.

여기서는 완성된 작업의 테스트 커버리지를 생성합니다. 코드 리뷰가 아니며 변경 사항 둘러보기에서 제안하는 수동 확인도 아닙니다.

어떤 경로를 선택해야 하나요?

기준	내장 QA	TEA
적합한 경우	구현된 기능의 테스트 커버리지 추가	전략, 추적성 또는 출시 게이트가 필요할 때
설정	BMM에 포함	TEA 모듈 별도 설치
접근 방식	현재 구현된 코드에서 테스트 생성	먼저 계획한 뒤 추적성을 유지하며 생성
다루는 범위	API 및 E2E 테스트	설계, ATDD, 자동화, 리뷰, NFR, 게이트
전략	정상 경로와 몇 가지 주요 오류	위험 기반 우선순위(P0~P3)

`bmad-qa-generate-e2e-tests` 실행하기

새 채팅을 열고 스킬 이름을 말하세요. 명령 전후나 명령과 함께 기능, 디렉터리 또는 “테스트되지 않은 부분을 찾아 줘”처럼 대상을 설명할 수 있습니다.

/bmad-qa-generate-e2e-tests

/bmad-qa-generate-e2e-tests 로그인 흐름의 API 및 E2E 테스트를 만들어 줘.

프로젝트에서 이미 사용하는 테스트 프레임워크를 그대로 활용합니다. 프레임워크가 없다면 기술 스택을 확인하고 하나를 제안합니다.

실행 과정

테스트 프레임워크 감지 - 의존성과 기존 테스트를 살펴 Playwright, Jest, Vitest, Cypress 같은 프레임워크를 찾습니다.
기능 식별 - 무엇을 테스트할지 묻거나 코드베이스에서 기능을 자동으로 찾습니다.
API 테스트 생성 - 엔드포인트가 있다면 상태 코드, 응답 구조, 정상 경로, 오류 사례 한두 개를 검사합니다.
E2E 테스트 생성 - UI가 있다면 역할, 레이블, 텍스트 같은 의미 기반 로케이터와 사용자에게 보이는 결과 검증으로 사용자 흐름을 다룹니다.
테스트 실행 - 생성한 테스트를 실행하고 실패하면 바로 수정합니다.
요약 작성 - 생성한 테스트와 아직 다루지 못한 범위를 기록합니다.

생성된 테스트는 의도적으로 단순하게 유지됩니다. 표준 프레임워크 API를 사용하고 각 테스트는 서로 독립적이며 하드코딩된 대기를 넣지 않습니다. 테스트 설명은 기능 문서처럼 읽을 수 있게 작성됩니다.

얻는 결과

프로젝트의 tests/ 디렉터리에 생성된 테스트 파일
구현 산출물 디렉터리의 tests/test-summary.md에 저장된 테스트 요약
이번 세션에서 한 번 이상 실행해 통과한 테스트

제한 사항

bmad-qa-generate-e2e-tests는 테스트만 생성합니다. 구현을 검토하지 않습니다. 구현 중에는 bmad-build가 검토하고 추가 검토가 필요하면 bmad-code-review를 사용하세요.

테스트 전략, 위험 순위, 요구사항 추적성, NFR 근거, 출시 여부를 결정하는 게이트는 만들지 않습니다. PRD나 아키텍처를 불러와 요구사항과 커버리지를 연결하지도 않습니다. 정상 경로와 몇 가지 주요 오류까지만 다루며 더 많은 엣지 케이스는 후속 작업으로 남습니다.

TEA를 사용해야 할 때

다음과 같이 내장 스킬만으로 부족하다면 TEA를 설치하세요.

요구사항 추적성이나 컴플라이언스 근거가 필요할 때
여러 기능의 테스트 우선순위를 위험도에 따라 정해야 할 때
정식 품질 게이트로 출시 여부를 결정할 때
테스트를 작성하기 전에 테스트 전략이 필요할 때
하나의 테스트 생성·실행 스킬로 다루기에는 작업이 너무 커졌을 때

TEA는 별도 모듈입니다. 현재 워크플로, 명령, 설정 방법은 TEA 문서를 참고하세요. 다른 BMad 모듈과 함께 설치할 수 있습니다. 모듈 선택 방법은 공식 모듈에서 확인하세요.

워크플로에서의 위치

bmad-build는 변경을 구현하고 기존 테스트 모음이 있다면 모두 통과하는 상태로 작업을 마칩니다. 그다음 이 페이지의 테스트 경로를 선택합니다. 완성된 작업에 API 및 E2E 커버리지를 추가하거나 TEA로 전환하면 됩니다.

내장 QA는 변경 하나가 끝날 때마다 실행할 수 있습니다. 에픽이 모두 끝날 때까지 기다릴 필요가 없습니다. 일반적으로 bmad-build로 구현하고 필요하면 결과를 둘러본 뒤 여기서 테스트를 생성합니다. 에픽 전체가 끝난 후 실행하는 bmad-retrospective는 목적이 다릅니다. 테스트 모음이 아니라 상위 사양을 기준으로 에픽 전체를 평가합니다.