Browser Silent-Failure Triage

※ 이 상품은 노션 템플릿이 아니라 AI 에이전트가 직접 실행하는 "스킬 파일"(SKILL.md)입니다. Claude Code 등 AI 에이전트에게 넘기면, 브라우저 자동화 스크립트가 "성공"이라고 하는데 아무것도 안 바뀌는 문제의 원인을 진단해 줍니다.

Playwright·Puppeteer·Selenium 스크립트에서 로그에는 saved가 찍히는데 파일이 업로드되지 않았거나, 저장이 안 됐거나, 클릭이 아무 일도 안 일으킨 적 있으시죠? 이 스킬은 그런 "조용한 실패"를 추측이 아니라 증거로 좁혀 갑니다.

1단계 — 증상 정리: 스크립트가 보고한 것과 화면·서버에 실제로 나타난 것을 나눠 적고, 이미 시도한 것을 확인합니다.

2단계 — 원인 후보: 알려진 14가지 조용한 실패 원인(페이지 미하이드레이션, 비활성 버튼, 가려진 오버레이, 엉뚱한 요소 선택, 파일 입력 없음, 미리보기만 되고 업로드 안 됨, 조용한 리다이렉트, 페이지 URL로 전송, 자동완성이 입력 삼킴 등)에서 근거순으로 순위를 매깁니다.

3단계 — 확인용 프로브: 모든 비-GET 요청 로깅, 파일 입력 개수 확인, 클릭 지점을 덮은 요소 확인 등 복사해 쓰는 코드와 "이렇게 나오면 이 원인"이라는 판단 규칙을 줍니다.

4단계 — 수정과 검증: 프로브 결과가 나온 뒤에만 가장 작은 수정안과, 새로고침·서버 조회로 결과를 증명하는 확인법을 알려 줍니다.

한계 — 스크립트를 대신 실행하지 않습니다. 봇 차단·CAPTCHA·로그인 장벽 우회는 도와드리지 않습니다. 비밀번호·토큰은 지우고 붙여 넣으세요. 1회성 파일이며 구독이 아닙니다.

포함 내용 — SKILL.md 1개(Claude Code, Codex, OpenClaw에서 동작), 사용법 안내 텍스트 1개.

대상 — 브라우저 자동화·E2E 테스트를 직접 짜고 "통과했는데 데이터가 없다"는 문제로 시간을 쓰는 개발자.