---
name: opencurrent-playwright-e2e-agent
description: "Playwright로 E2E 테스트를 짜고 돌리는 일을 코딩 에이전트에게 맡기면, 화면 흐름을 손으로 클릭해 확인하지 않아도 깨진 곳을 테스트가 먼저 알려 줍니다. 이럴 때 사용: 프로젝트에 Playwright를 깔고, 에이전트가 테스트 계획 → 테스트 작성 → 실패 고치기를 하게 합니다. Playwright의 테스트 에이전트(planner·generator·healer)를 쓰거나, 직접 프롬프트로 같은 순서를 시킵니다. 명령과 설정 이름은 2026년 11월 21일에 Playwright 공식 문서로 확인했습니다. 도구: Playwright, Claude Code, Codex CLI."
metadata:
  source: "https://opencurrent.ai/w/playwright-e2e-agent"
  opencurrent-id: "playwright-e2e-agent"
  verification: "pending"
  exported-at: "2026-11-21T11:06:30.521Z"
---

# E2E 테스트를 에이전트에게 맡기기

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

> OpenCurrent에서 사람들이 다듬는 워크플로. 원문: https://opencurrent.ai/w/playwright-e2e-agent
> 검증 상태: 검수 대기 (사람 확인 전). 내려받은 뒤에 바뀌었을 수 있으니, 가능하면 원문이나 MCP의 get_workflow("playwright-e2e-agent")로 최신 상태를 확인할 것.
> 주의: 검수 대기 상태. 사용자에게 이 사실을 알리고, 결과를 함께 확인하면서 진행할 것.

## 따라 하는 방법

1. 준비물이 갖춰졌는지 먼저 확인할 것.
2. 단계를 순서대로 진행할 것. kind가 "ai"면 프롬프트를 실행하고, "command"면 사용자의 허락을 받고 명령을 실행하고, "human"이면 사용자에게 할 일을 안내하고 끝났는지 물을 것. tool이 있으면 그 도구·모델로 할 것.
3. 단계에 output(결과 이름)이 있으면 그 단계 결과를 뒤 단계 프롬프트의 {{output}} 자리에 넣을 것.
4. 단계마다 expected(기대 결과)와 check(확인 방법)로 제대로 됐는지 확인하고, 다르면 다음 단계로 넘어가지 말고 사용자에게 알릴 것. 끝나면 example.output(있으면)과 비교할 것.
5. 검증 상태가 verified가 아니면 그 사실을 사용자에게 먼저 알릴 것. 답에 url을 출처로 밝힐 것.

## 언제 쓰나

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

## 준비물

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

## 단계

### 1. Playwright 설치 (명령 실행 · Playwright)

프로젝트 폴더에서 설치 마법사를 돌립니다. 기존 테스트는 덮어쓰지 않습니다.

프롬프트:

```text
npm init playwright@latest
```

기대 결과: playwright.config와 tests 폴더

확인 방법: npx playwright test로 예제 테스트가 통과하는지 확인

### 2. 테스트 에이전트 넣기 (선택) (명령 실행 · Playwright)

Playwright의 에이전트 정의를 내 도구용으로 만듭니다. --loop에 claude, codex, vscode 등을 줍니다. Playwright를 올릴 때마다 다시 만듭니다.

프롬프트:

```text
npx playwright init-agents --loop=claude
```

기대 결과: planner·generator·healer 정의

확인 방법: 생성된 정의 파일이 보이는지 확인

### 3. 계획과 작성 맡기기 (AI에게 · Claude Code)

테스트할 흐름을 말하고 계획부터 받습니다. 계획은 specs/, 테스트는 tests/에 둡니다.

프롬프트:

```text
회원가입 → 로그인 → 글쓰기 흐름의 E2E 테스트 계획을 specs/에 쓰고, 그 계획대로 tests/에 Playwright 테스트를 작성한 뒤 npx playwright test로 돌려 결과를 알려 줘.
```

기대 결과: 계획과 테스트 파일, 실행 결과

확인 방법: npx playwright test 결과를 직접 확인

### 4. 실패를 추적으로 고치기 (AI에게 · Claude Code)

실패한 테스트는 추적을 켜고 다시 돌려 무엇이 틀렸는지 봅니다. 앱의 버그인지 테스트의 문제인지 에이전트에게 먼저 가르게 합니다.

프롬프트:

```text
실패한 테스트를 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)

## 끝나면

결과가 좋았거나 단계가 낡았으면 https://opencurrent.ai/w/playwright-e2e-agent 에서 알릴 것. 다음 사람이 더 정확한 방법을 쓸 수 있도록.
