E2E 테스트를 에이전트에게 맡기기
Playwright로 E2E 테스트를 짜고 돌리는 일을 코딩 에이전트에게 맡기면, 화면 흐름을 손으로 클릭해 확인하지 않아도 깨진 곳을 테스트가 먼저 알려 줍니다.
프로젝트에 Playwright를 깔고, 에이전트가 테스트 계획 → 테스트 작성 → 실패 고치기를 하게 합니다. Playwright의 테스트 에이전트(planner·generator·healer)를 쓰거나, 직접 프롬프트로 같은 순서를 시킵니다. 명령과 설정 이름은 2026년 11월 21일에 Playwright 공식 문서로 확인했습니다.
준비
- Node.js
- 코딩 에이전트(Claude Code, Codex 등)
- 로컬에서 돌아가는 웹앱
1. Playwright 설치
프로젝트 폴더에서 설치 마법사를 돌립니다. 기존 테스트는 덮어쓰지 않습니다.
npm init playwright@latest결과: playwright.config와 tests 폴더
확인: npx playwright test로 예제 테스트가 통과하는지 확인
2. 테스트 에이전트 넣기 (선택)
Playwright의 에이전트 정의를 내 도구용으로 만듭니다. --loop에 claude, codex, vscode 등을 줍니다. Playwright를 올릴 때마다 다시 만듭니다.
npx playwright init-agents --loop=claude결과: planner·generator·healer 정의
확인: 생성된 정의 파일이 보이는지 확인
3. 계획과 작성 맡기기
테스트할 흐름을 말하고 계획부터 받습니다. 계획은 specs/, 테스트는 tests/에 둡니다.
회원가입 → 로그인 → 글쓰기 흐름의 E2E 테스트 계획을 specs/에 쓰고, 그 계획대로 tests/에 Playwright 테스트를 작성한 뒤 npx playwright test로 돌려 결과를 알려 줘.결과: 계획과 테스트 파일, 실행 결과
확인: npx playwright test 결과를 직접 확인
4. 실패를 추적으로 고치기
실패한 테스트는 추적을 켜고 다시 돌려 무엇이 틀렸는지 봅니다. 앱의 버그인지 테스트의 문제인지 에이전트에게 먼저 가르게 합니다.
실패한 테스트를 npx playwright test --trace on 으로 다시 돌리고, 앱 버그인지 테스트 문제인지 근거와 함께 나눠 줘. 테스트를 통과시키려고 기대값을 바꾸지는 마.결과: 원인 구분과 수정
확인: npx playwright show-report로 결과 확인
주의
- 에이전트가 통과시키려고 기대값을 바꾸는 일이 있음. 테스트 변경은 따로 확인
- 로그인 정보는 테스트용 계정으로. 실제 비밀번호를 테스트에 적지 않기
- Node 버전 요구 확인(Playwright 설치 문서 기준)
참고 자료
- 1Playwright 문서: 테스트 에이전트playwright.dev
- 2Playwright 문서: 추적 보기playwright.dev
댓글