Reticle·stillworks 정리: 에이전트가 앱을 클릭해 직접 검증
3줄 요약
- Reticle은 코딩 에이전트가 웹·데스크톱 앱을 실제로 조작한 뒤, 요청·응답과 콘솔 오류까지 묶어 통과/실패/판단 불가로 알려 주는 도구입니다 [1].
- stillworks는 회원가입·로그인·결제 같은 핵심 흐름을 브라우저에서 자동으로 눌러 보고, 실패하면 에이전트에게 바로 넘길 수 있는 보고서를 만드는 MIT 라이선스 CLI입니다 [2].
- 두 도구 모두 '코드는 맞는데 제품은 깨진' 상황, 즉 테스트는 초록불인데 실제 사용자 흐름이 망가진 문제를 겨냥합니다 [1][2].
무엇이 나왔나
DEV Community 글은 익숙한 사고 하나를 예로 듭니다. 에이전트가 회원가입 API를 정리하면서 서버가 읽는 필드 이름을 emailAddress로 바꿨는데, 폼은 여전히 email을 보냅니다 [2]. 요청 본문 타입이 경계에서 any라 TypeScript는 조용하고, 에이전트가 단위 테스트도 새 이름에 맞춰 고쳐 놓아 테스트는 모두 통과합니다 [2]. 그런데 브라우저에서는 가입 버튼이 아무 반응이 없고, 네트워크 탭에는 500 오류가 찍힙니다 [2]. 글쓴이는 이를 두고 테스트는 코드를 확인했을 뿐 제품을 확인한 사람은 없었다고 정리합니다 [2].
Reticle은 이 빈틈을 에이전트 쪽에서 메우는 도구입니다. 기능을 고친 에이전트가 앱 화면에서 직접 입력하고 버튼을 눌러, 로그인이나 결제가 의도대로 되는지 확인합니다 [1]. 클릭 뒤에 이어진 API 요청과 응답, 콘솔 오류, 화면 변화, 사전에 등록한 앱 상태를 한꺼번에 살핍니다 [1]. 그래서 결제 버튼 한 번에 주문 요청이 두 번 나가는 식의 문제도 잡을 수 있다고 소개됩니다 [1]. 판정이 실패면 근거가 된 요청이나 조건을 남기고, 소스 위치가 연결돼 있으면 파일과 줄 번호까지 보여 줍니다 [1]. MCP(에이전트가 외부 도구를 호출하는 표준 연결 방식)로 Claude Code, Cursor, Codex 등에 붙일 수 있고, React/Vite·Next.js 웹앱과 Electron/Tauri 앱의 웹뷰를 지원합니다 [1].
stillworks는 사람이 정한 '여정(journey)'을 Playwright(브라우저 자동화 라이브러리) 단계로 적어 두고 실행하는 CLI입니다 [2]. 초기화하면 journeys.config.ts 파일이 생기고 Chromium이 설치됩니다 [2].
어떻게 써먹나
1. 웹 프로젝트를 빠르게 훑어보기 (Reticle)
발표에 따르면 아래 명령 하나로 별도 설정 없이 페이지 로딩 여부, 콘솔에 뜬 오류, 실패한 네트워크 요청, 사이트 내부 링크 상태를 점검할 수 있습니다 [1].
npx @reticlehq/server
검증이 끝난 작업은 플로우로 저장해 AI 모델 없이 다시 돌릴 수 있고, CI에 넣어 코드가 바뀐 뒤에도 같은 기능이 살아 있는지 확인하는 용도로 쓸 수 있습니다 [1].
2. 핵심 흐름을 여정으로 고정하기 (stillworks)
npx stillworks init
각 여정은 '가입 페이지 열기 → 이메일·비밀번호 입력 → 제출 → 환영 화면 확인'처럼 이름 붙은 단계 목록입니다 [2]. 직접 쓰기 번거롭다면 에이전트에게 설정 파일을 읽고 새 여정을 추가해 달라고 요청하면 된다고 글은 권합니다 [2]. 실행할 때는 run 명령에 로컬 개발 서버 주소를 --url 옵션으로 넘깁니다 [2].
3. 실패 보고서를 에이전트에게 그대로 넘기기
여정이 깨지면 REPORT.md가 만들어집니다 [2]. 여기에는 실패한 단계, 콘솔 오류, 서버 응답이 담긴 실패 요청, 스크린샷이 들어가고, 관련 없는 파일은 건드리지 말고 원인을 찾으라는 지시와 함께 다른 여정은 계속 통과시키라는 조건이 붙습니다 [2]. 글쓴이는 이 덕분에 에이전트가 엉뚱하게 예외 처리를 덧붙이지 않고 바뀐 필드 이름으로 바로 간다고 설명합니다 [2].
4. 에이전트 루프에 붙이기
Claude Code에서는 Stop 훅으로 작업이 끝날 때마다 여정을 돌리고, 실패하면 보고서를 다시 Claude에게 돌려 통과할 때까지 고치게 할 수 있습니다 [2]. 파일 변경이 없던 턴은 건너뛰고, 앱이 꺼져 있으면 막지 않는다고 합니다 [2]. Cursor용 규칙, Codex·Copilot용 AGENTS.md 섹션, Vercel 프리뷰 배포마다 실행하는 GitHub Action도 준비돼 있다고 소개됩니다 [2].
주의할 점
- Reticle의 지원 범위는 React/Vite, Next.js, Electron/Tauri 웹뷰로 안내돼 있습니다 [1]. 그 밖의 프레임워크 지원 여부는 자료에서 확인되지 않았습니다.
- 라이선스는 Reticle npm 패키지가 Apache-2.0, Tauri용 Rust 크레이트가 MIT이고 [1], stillworks는 MIT이며 텔레메트리가 없고 macOS·Linux·Windows에서 동작한다고 합니다 [2]. Reticle의 가격 정책은 자료에 나오지 않습니다.
- stillworks는 요청할 때 돌아가는 도구이고, PR마다 스스로 도는 후속 서비스 Publishub는 아직 출시 전입니다 [2].
- '판단 불가' 판정이 어떤 상황에서 나오는지, 플로우 재실행이 UI 변경에 얼마나 견디는지는 자료만으로는 알 수 없습니다.
정리
에이전트가 만든 변경은 타입 검사와 단위 테스트를 쉽게 통과하지만, 그것이 곧 제품이 동작한다는 뜻은 아닙니다 [2]. Reticle은 에이전트가 앱을 직접 눌러 보고 근거와 함께 판정하게 하는 쪽이고 [1], stillworks는 사람이 정한 핵심 흐름을 매번 브라우저로 확인하고 결과를 에이전트에게 돌려주는 쪽입니다 [2]. 우선 회원가입·로그인·결제처럼 깨지면 매출과 직결되는 흐름 몇 개부터 자동 검증에 걸어 두는 것이 현실적인 출발점입니다.
참고 자료
- Reticle - AI 코딩 에이전트가 웹/데스크톱 앱을 직접 조작해 검증하는 도구 · GeekNews, 2026-11-19
- Your AI wrote the code, the tests passed, and signup is still broken · DEV Community, 2026-11-19