gstack의 /qa는 클로드코드(Claude Code)가 헤드리스 브라우저로 내 웹 앱을 실제로 열어 돌아다니며 버그를 찾고, 원인을 소스 코드에서 고치고, 같은 시나리오를 다시 돌려 재검증까지 하는 무료 오픈소스 QA 스킬이에요. 실행은 “/qa” 한 마디이고, 끝나면 수정 전후 건강 점수와 출시 준비도 요약이 나와요. 클로드코드 스킬 시리즈 2편이에요.
바이브코딩으로 “만들기”는 쉬워졌지만 “검증”이 빠지면 반쪽이라서, 제 워크플로에서 가장 중요한 스킬 중 하나예요. 앞 편은 rtk 토큰 절약 스킬이고, 스킬이 처음이면 스킬 개념편부터 보세요.
바이브코딩의 함정: 만들긴 했는데 정말 되는 걸까요?
AI 덕분에 앱 만들기는 정말 쉬워졌어요. 그런데 만들고 나면 더 어려운 질문이 남아요. “이거 진짜 제대로 도는 거 맞아?”
제가 직접 클릭해보는 건 검증이 아니에요. 저는 제가 만든 대로만 눌러보거든요. 빈 입력, 이상한 값, 뒤로가기 연타 같은 “사용자가 실제로 하는 행동”은 안 해봐요. 그래서 잘 돌던 앱이 남에게 보여주는 순간 깨져요. 이 공백을 메우는 게 QA(품질 검증) 스킬이에요.
/qa를 실행하면 어떻게 돌아가나요?
한 마디에 다섯 단계가 자동으로 이어져요.
- 탐색: AI가 헤드리스 브라우저(화면 없는 크롬)로 내 앱을 실제로 열어 페이지를 돌아다니며 버그를 찾아요
- 분류: 발견한 문제를 심각도(치명/높음/중간/외관)로 정리해요
- 수정: 버그의 원인을 소스 코드에서 찾아 고쳐요
- 기록: 수정 하나마다 커밋을 따로 남겨요. 잘못 고쳤으면 그것만 되돌릴 수 있어요
- 재검증: 고친 뒤 같은 시나리오를 다시 돌려서 진짜 고쳐졌는지 확인해요
끝나면 수정 전후 건강 점수와 출시 준비도 요약이 나와요. “지금 내보내도 되는 상태인가”를 점수로 보는 거예요.
QA 강도는 어떻게 고르나요?
3단계 티어가 있고 기본값은 Standard예요.
| 티어 | 범위 | 이럴 때 |
|---|---|---|
| Quick | 치명, 높음 버그만 | 배포 직전 빠른 점검 |
| Standard | + 중간 버그 | 평소 기능 개발 후 (기본값) |
| Exhaustive | + 외관, 디테일까지 | 출시 전 최종 점검 |
“고치지는 말고 리포트만 줘”가 필요하면 /qa-only 라는 보고서 전용 모드도 있어요. 수정을 내 눈으로 보고 승인하고 싶을 때 유용해요.
실사용: 앱 출시 전 최종 관문으로 쓰는 방법
저희는 화장품 커뮤니티 앱을 운영하면서 이 스킬을 출시 전 관문으로 써요. 기능을 만들면 QA 스킬을 돌리고, 통과해야 배포 후보가 돼요. 써보면서 배운 것 두 가지예요.
- 커밋 단위 수정이 생각보다 중요해요. AI가 고친 것 중 하나가 마음에 안 들면 그 커밋만 되돌리면 돼요. 뭉텅이로 고쳐놓으면 이게 안 돼요
- 자동 QA 통과가 끝이 아니에요. 로컬에서 통과해도 실기기에서만 터지는 버그가 있어요 (웹뷰 환경 차이 같은 것들요). 자동 QA로 90%를 거르고, 최종 확인은 실제 기기로 하는 조합이 정답이에요
자주 묻는 질문
Q. 어떤 앱에 쓸 수 있나요?
브라우저로 열리는 웹 앱이 대상이에요. 사이트, 웹 서비스, 웹뷰 기반 앱까지요. 모바일 네이티브 앱은 별도의 iOS용 QA 스킬이 따로 있어요.
Q. AI가 버그를 잘못 고치면 어떡하죠?
수정마다 커밋이 분리돼 있고 고친 뒤 재검증을 돌려서, 잘못된 수정만 되돌릴 수 있어요. 불안하면 /qa-only로 리포트만 받아서 수정은 직접 지시하는 방법도 있어요.
Q. 개발을 몰라도 쓸 수 있나요?
네, 실행은 “/qa 해줘” 한 마디예요. 다만 “치명 버그가 남아 있으면 배포 보류” 같은 판단은 본인이 해야 해요. 그 판단 기준까지 보고서가 잡아줘서 어렵진 않아요.
Q. 무료인가요?
네, 스킬 자체는 무료 오픈소스 모음 gstack에 들어 있어요. 클로드코드 구독만 있으면 추가 비용은 없어요. 공식 저장소는 github.com/garrytan/gstack 이고 MIT 라이선스예요.
다음 스킬: ponytail
다음 편은 ponytail 스킬이에요. AI에게 “게으른 시니어 개발자” 마인드를 심어서 꼭 필요한 최소한의 코드만 쓰게 하는 스킬인데, 과잉 구현을 막아줘서 유지보수가 확 편해져요. 같은 gstack 패키지의 배포 전 코드 리뷰는 /review 코드 리뷰 스킬편에서 다뤄요.
Leave a Reply