Papercuts

핵심 발상은 Papercuts가 샌드박스가 아니라 돌아가는 앱을 상대로 작동한다는 점이다. 헤드리스 브라우저 무리를 만들어 사용자와 똑같이 환경에 들어간다. SDK도 코드 변경도 필요 없다. 즉 고객이 닿는 것과 같은 렌더링 경로, 같은 서드파티 스크립트, 같은 데이터를 테스트한다. 일반적인 웹 앱 테스트가 항상 재현할 수 있는 건 아니다. Papercuts는 이를, 많은 팀이 걸려 넘어지는 스테이징과 프로덕션의 간극에 대한 직접적인 답으로 본다.

Papercuts는 에이전트를 두 모드로 나눈다. 결정론적 에이전트는 정밀하게 유도되며 핵심 경로를 위해 만들어졌다. 쉬운 한국어로 목표를 쓰면 에이전트가 단계를 실행한다. 탐색형 에이전트는 반대다. URL을 주면 호기심 많은 사용자처럼 앱을 돌아다니며 클릭하고 스크롤해 숨은 경계 사례를 끌어낸다. 스크립트가 아니라 모델이 이끄는 합성 사용자 테스트라고 생각하면 된다. 대부분의 팀은 둘 다 원할 것이다. 절대 깨지면 안 되는 흐름을 지키는 하나와 잊고 있던 흐름을 살피는 하나다.

에이전트는 하드코딩된 선택자를 대조하는 대신 사람처럼 인터페이스를 읽는다. Papercuts는 자사 에이전트가 "코드뿐 아니라 UI를 본다"고 말하며, 의미를 이해하기에 레이아웃이 바뀌어도 계속 작동한다. 전통적인 테스트 스위트가 보통 무너지는 지점이 바로 여기다. 버튼이 움직이면 기능이 아직 돌아가도 선택자가 깨질 수 있다. 적응형 인지는 리뉴얼 후 오탐을 줄인다. 빠르게 변하는 코드베이스에서는 큰 차이다.

에이전트가 오류를 만나면 Papercuts는 모호한 실패 신호 대신 진단 보고서를 이메일로 보낸다. 보고서에는 실행 흐름의 단계별 분석, 고해상도 스크린샷, 네트워크 요청 로그, 에이전트 자체의 추론 기록이 담긴다. 버그를 직접 재현할 만큼의 맥락이 주어지므로 에이전트가 무엇을 봤는지 알아내는 주고받음이 줄어든다. 전담 QA 인력이 없는 작은 팀에게 유용한 경보와 소음의 차이는 거기에 있다.

앱은 표면적의 많은 부분을 로그인 뒤에 둔다. 로그인 화면을 넘지 못하는 테스트 도구는 그 대부분을 놓친다. Papercuts는 사용자 이름이나 이메일과 비밀번호를 플랫폼에 저장하게 하고, 에이전트가 그 자격 증명으로 실제 사용자처럼 로그인해 보호된 경로를 테스트한다. 이로써 대시보드, 계정 설정, 인증 뒤에 잠긴 모든 것으로 커버리지가 넓어진다.

Papercuts는 GitHub Actions, Linear, Slack, Datadog 같은 도구와 연결되므로 실패가 팀이 이미 일하는 곳에 나타난다. 프로그램으로 실행을 트리거하고 결과를 가져오는 REST API도 있다. 브라우저 탭이 아니라 CI 파이프라인에서 QA를 조율하고 싶을 때 중요하다. 제품이 또 하나 확인할 곳이 되는 대신 기존 워크플로에 들어맞는 방식이다.