agent-qa 브라우저 회귀 테스트 (Spring Boot 3)
실행 중인 Spring Boot 3 앱의 브라우저 사용자 여정을 agent-qa로 안전하게 검증하고, 실제 실행 증거만으로 결과를 보고하게 하는 스킬입니다.
개발·코딩고급★ 338⑂ 54AI 점수 8/10마지막 업데이트: 2026. 11. 2.
무엇을 해주나
- 실행 중인 Spring Boot 3 애플리케이션에 대해
agent-qaCLI로 브라우저 기반 회귀 테스트를 수행할 때의 절차와 규칙을 Claude에게 주입합니다. - 대상 선정(실제 UI origin vs 리버스 프록시 vs Actuator 관리 포트 구분), 범위를 좁힌 실행(validate → dry-run → 인가된 경우에만 실제 실행), 실행 증거 확보(run ID, digest, runs overview, step evidence), memidex 메모리 출처 추적의 4단계를 강제합니다.
- MockMvc·리포지토리 테스트·Testcontainers 같은 기존 백엔드 테스트를 브라우저 테스트로 대체하지 않도록 막고, 테스팅 피라미드를 유지합니다.
- 인증/인가, CSRF, 테넌트 경계, 응답 포맷을 보존하도록 강제합니다. 403이 떴다고 보안을 끄는 식의 우회를 금지합니다.
- 자격증명은
workspace.secretsFile에 두고 테스트에서는{{secret:NAME}}로만 참조하게 하며, 스크린샷·영상 아티팩트의 민감정보 노출을 경고합니다. - dry-run 성공이나 exit 0을 "통과"로 둔갑시키지 않고, 실제 네이티브 판정 텍스트를 그대로 옮기며 실행 불가 상황은 별도의 '한계'로 보고하게 합니다.
이런 분께 추천
- 브라우저 UI가 있는 Spring Boot 3 애플리케이션을 운영하며 자연어 기반 E2E 테스트 도구(agent-qa)를 도입했거나 도입을 검토 중인 팀
- AI 에이전트가 "테스트 통과했습니다"라고 보고했지만 실제로는 헬스체크만 확인한 상황을 겪어본 QA/백엔드 엔지니어
- 테스트를 통과시키려고 보안 설정을 끄는 에이전트 행동을 사전에 차단하고 싶은 리드 개발자
- 반대로 API 전용 서비스나 agent-qa를 쓰지 않는 팀에는 맞지 않습니다(스킬 자체가 HTTP/통합 테스트 스킬을 쓰라고 안내합니다).
활용 예시
- 결제 플로우 회귀 검증: "체크아웃 여정이 이번 배포에서도 동작하는지 확인해줘" → 기존
tests/checkout.yaml을 리뷰하고agent-qa validate→--dry-run→ 인가 확인 후--build-tag "$APP_BUILD_TAG"로 실제 실행, 그 다음 run ID 기반으로 digest와 step evidence를 읽어 보고. - 실패 원인 분류: 실행 결과가 실패했을 때 애플리케이션 결함인지, 테스트 기대값 문제인지, 환경(자격증명·인프라) 문제인지, 에이전트 판정 불확실인지 구분해 보고하고 최소 단위의 다음 조치를 제안.
- memidex 메모리 검증: 과거 성공 기록이 현재 실패와 충돌할 때
agent-qa runs knowledge RUN_ID --json과knowledge inspect로 출처와 현재 유효성을 확인하되, 리뷰 중에 메모리를 승인/삭제하지 않도록 제한.
· · · 설치 가이드 · · ·
설치 없이 지금 한 번 써보기
아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.
이 파일의 지시를 읽고 그대로 따라서 나를 도와줘: https://raw.githubusercontent.com/rrezartprebreza/spring-boot-skills/HEAD/skills/spring-boot-3/agent-qa-browser-regression/SKILL.md 내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)
Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.
↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
AI 스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 rrezartprebreza/spring-boot-skills 의 skills/spring-boot-3/agent-qa-browser-regression 폴더를 내 ~/.claude/skills/agent-qa-browser-regression/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/rrezartprebreza/spring-boot-skills.git && mkdir -p ~/.claude/skills && cp -r spring-boot-skills/skills/spring-boot-3/agent-qa-browser-regression ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 열고 스킬을 보관할 위치로 이동합니다.
- 저장소를 내려받습니다:
git clone https://github.com/rrezartprebreza/spring-boot-skills.git - Claude 스킬 폴더를 준비합니다:
mkdir -p ~/.claude/skills - 이 스킬 디렉터리를 통째로 복사합니다(동봉된
examples/파일까지 함께 가야 합니다):cp -r spring-boot-skills/skills/spring-boot-3/agent-qa-browser-regression ~/.claude/skills/ - 참조 스킬인
testing-pyramid도 함께 복사해두면 링크가 끊기지 않습니다:cp -r spring-boot-skills/skills/spring-boot-3/testing-pyramid ~/.claude/skills/ - 사전 준비: Node.js 24 이상 설치,
agent-qaCLI 설치, 프로젝트 루트에agent-qa.config.yaml과workspace.secretsFile설정을 완료합니다. - Claude Code를 재시작한 뒤 "실행 중인 앱에서 체크아웃 여정을 agent-qa로 검증해줘"처럼 요청하면 스킬이 발동합니다.
- 실제 실행은 반드시 폐기 가능한 테스트 환경에서 먼저 시도하고, 운영 환경 실행은 명시적 승인 절차를 거치세요.
GitHub에서 원본 보기 ↗라이선스: MIT