# E2E 테스트를 에이전트에게 맡기기
id: playwright-e2e-agent · 종류: 워크플로 · 상태: 검수 대기 (사람 확인 전) · 주제: 개발
주소: https://opencurrent.ai/w/playwright-e2e-agent
기준일: 2026-11-21 (여기서 고친 날)
도구: Playwright, Claude Code, Codex CLI
걸리는 시간: 약 30분
평가 점수: 32/100 (확인 없음 · 검수 대기)

Playwright로 E2E 테스트를 짜고 돌리는 일을 코딩 에이전트에게 맡기면, 화면 흐름을 손으로 클릭해 확인하지 않아도 깨진 곳을 테스트가 먼저 알려 줍니다.

설명: 프로젝트에 Playwright를 깔고, 에이전트가 테스트 계획 → 테스트 작성 → 실패 고치기를 하게 합니다. Playwright의 테스트 에이전트(planner·generator·healer)를 쓰거나, 직접 프롬프트로 같은 순서를 시킵니다. 명령과 설정 이름은 2026년 11월 21일에 Playwright 공식 문서로 확인했습니다.

준비물: Node.js · 코딩 에이전트(Claude Code, Codex 등) · 로컬에서 돌아가는 웹앱

단계:
1. [명령 실행 · Playwright] Playwright 설치 — 프로젝트 폴더에서 설치 마법사를 돌립니다. 기존 테스트는 덮어쓰지 않습니다.
   프롬프트:
   > npm init playwright@latest
   기대 결과: playwright.config와 tests 폴더
   확인 방법: npx playwright test로 예제 테스트가 통과하는지 확인
2. [명령 실행 · Playwright] 테스트 에이전트 넣기 (선택) — Playwright의 에이전트 정의를 내 도구용으로 만듭니다. --loop에 claude, codex, vscode 등을 줍니다. Playwright를 올릴 때마다 다시 만듭니다.
   프롬프트:
   > npx playwright init-agents --loop=claude
   기대 결과: planner·generator·healer 정의
   확인 방법: 생성된 정의 파일이 보이는지 확인
3. [AI에게 · Claude Code] 계획과 작성 맡기기 — 테스트할 흐름을 말하고 계획부터 받습니다. 계획은 specs/, 테스트는 tests/에 둡니다.
   프롬프트:
   > 회원가입 → 로그인 → 글쓰기 흐름의 E2E 테스트 계획을 specs/에 쓰고, 그 계획대로 tests/에 Playwright 테스트를 작성한 뒤 npx playwright test로 돌려 결과를 알려 줘.
   기대 결과: 계획과 테스트 파일, 실행 결과
   확인 방법: npx playwright test 결과를 직접 확인
4. [AI에게 · Claude Code] 실패를 추적으로 고치기 — 실패한 테스트는 추적을 켜고 다시 돌려 무엇이 틀렸는지 봅니다. 앱의 버그인지 테스트의 문제인지 에이전트에게 먼저 가르게 합니다.
   프롬프트:
   > 실패한 테스트를 npx playwright test --trace on 으로 다시 돌리고, 앱 버그인지 테스트 문제인지 근거와 함께 나눠 줘. 테스트를 통과시키려고 기대값을 바꾸지는 마.
   기대 결과: 원인 구분과 수정
   확인 방법: npx playwright show-report로 결과 확인

주의:
- 에이전트가 통과시키려고 기대값을 바꾸는 일이 있음. 테스트 변경은 따로 확인
- 로그인 정보는 테스트용 계정으로. 실제 비밀번호를 테스트에 적지 않기
- Node 버전 요구 확인(Playwright 설치 문서 기준)

출처:
- Playwright 문서: 시작하기 https://playwright.dev/docs/intro
- Playwright 문서: 테스트 에이전트 https://playwright.dev/docs/test-agents
- Playwright 문서: 추적 보기 https://playwright.dev/docs/trace-viewer