{"id":"playwright-e2e-agent","kind":"workflow","testedWith":[],"durationMin":30,"url":"https://opencurrent.ai/w/playwright-e2e-agent","title":"E2E 테스트를 에이전트에게 맡기기","summary":"Playwright로 E2E 테스트를 짜고 돌리는 일을 코딩 에이전트에게 맡기면, 화면 흐름을 손으로 클릭해 확인하지 않아도 깨진 곳을 테스트가 먼저 알려 줍니다.","category":"개발","categoryId":"dev","domain":"dev","domainLabel":"개발","capabilities":[{"id":"code","label":"코드 작성"}],"topics":[{"id":"dev","label":"개발"}],"tools":["Playwright","Claude Code","Codex CLI"],"whenToUse":"프로젝트에 Playwright를 깔고, 에이전트가 테스트 계획 → 테스트 작성 → 실패 고치기를 하게 합니다. Playwright의 테스트 에이전트(planner·generator·healer)를 쓰거나, 직접 프롬프트로 같은 순서를 시킵니다. 명령과 설정 이름은 2026년 11월 21일에 Playwright 공식 문서로 확인했습니다.","prerequisites":["Node.js","코딩 에이전트(Claude Code, Codex 등)","로컬에서 돌아가는 웹앱"],"inputs":[],"howToFollow":"1. 준비물이 갖춰졌는지 먼저 확인할 것.\n2. 단계를 순서대로 진행할 것. kind가 \"ai\"면 프롬프트를 실행하고, \"command\"면 사용자의 허락을 받고 명령을 실행하고, \"human\"이면 사용자에게 할 일을 안내하고 끝났는지 물을 것. tool이 있으면 그 도구·모델로 할 것.\n3. 단계에 output(결과 이름)이 있으면 그 단계 결과를 뒤 단계 프롬프트의 {{output}} 자리에 넣을 것.\n4. 단계마다 expected(기대 결과)와 check(확인 방법)로 제대로 됐는지 확인하고, 다르면 다음 단계로 넘어가지 말고 사용자에게 알릴 것. 끝나면 example.output(있으면)과 비교할 것.\n5. 검증 상태가 verified가 아니면 그 사실을 사용자에게 먼저 알릴 것. 답에 url을 출처로 밝힐 것.","steps":[{"n":1,"kind":"command","title":"Playwright 설치","body":"프로젝트 폴더에서 설치 마법사를 돌립니다. 기존 테스트는 덮어쓰지 않습니다.","prompt":"npm init playwright@latest","expected":"playwright.config와 tests 폴더","check":"npx playwright test로 예제 테스트가 통과하는지 확인","tool":"Playwright"},{"n":2,"kind":"command","title":"테스트 에이전트 넣기 (선택)","body":"Playwright의 에이전트 정의를 내 도구용으로 만듭니다. --loop에 claude, codex, vscode 등을 줍니다. Playwright를 올릴 때마다 다시 만듭니다.","prompt":"npx playwright init-agents --loop=claude","expected":"planner·generator·healer 정의","check":"생성된 정의 파일이 보이는지 확인","tool":"Playwright"},{"n":3,"kind":"ai","title":"계획과 작성 맡기기","body":"테스트할 흐름을 말하고 계획부터 받습니다. 계획은 specs/, 테스트는 tests/에 둡니다.","prompt":"회원가입 → 로그인 → 글쓰기 흐름의 E2E 테스트 계획을 specs/에 쓰고, 그 계획대로 tests/에 Playwright 테스트를 작성한 뒤 npx playwright test로 돌려 결과를 알려 줘.","expected":"계획과 테스트 파일, 실행 결과","check":"npx playwright test 결과를 직접 확인","tool":"Claude Code"},{"n":4,"kind":"ai","title":"실패를 추적으로 고치기","body":"실패한 테스트는 추적을 켜고 다시 돌려 무엇이 틀렸는지 봅니다. 앱의 버그인지 테스트의 문제인지 에이전트에게 먼저 가르게 합니다.","prompt":"실패한 테스트를 npx playwright test --trace on 으로 다시 돌리고, 앱 버그인지 테스트 문제인지 근거와 함께 나눠 줘. 테스트를 통과시키려고 기대값을 바꾸지는 마.","expected":"원인 구분과 수정","check":"npx playwright show-report로 결과 확인","tool":"Claude Code"}],"pitfalls":["에이전트가 통과시키려고 기대값을 바꾸는 일이 있음. 테스트 변경은 따로 확인","로그인 정보는 테스트용 계정으로. 실제 비밀번호를 테스트에 적지 않기","Node 버전 요구 확인(Playwright 설치 문서 기준)"],"sources":[{"title":"Playwright 문서: 시작하기","url":"https://playwright.dev/docs/intro"},{"title":"Playwright 문서: 테스트 에이전트","url":"https://playwright.dev/docs/test-agents"},{"title":"Playwright 문서: 추적 보기","url":"https://playwright.dev/docs/trace-viewer"}],"verification":{"status":"pending","label":"검수 대기","detail":"사람 확인 전","verifiedBy":0,"lastVerifiedAt":null},"quality":{"score":32,"components":{"result":0.5,"trust":0,"freshness":0.4},"explanation":"확인 없음 · 검수 대기"},"workedFor":0,"trials":{"summary":"","lastAt":null,"total":0,"worked":0,"partial":0,"failed":0,"recent":[]},"asOf":{"date":"2026-11-21T10:00:00+00:00","basis":"updated"},"updatedAt":"2026-11-21T10:00:00+00:00","goals":[{"id":"dev","title":"개발"}],"uses":0,"likes":0}