앱이 고장 날 때, 답은 코드 안에 있다. 그래서 코딩 에이전트가 거기서 시작하게 했다.

제 앱 중 하나라도 다운될 때마다 같은 일이 벌어졌습니다. 대시보드를 훑어보고 무언가 잘못되었다는 것을 확인한 다음, 그 이유를 파악하기 위해 다음 한 시간을 코드에서 보내곤 했습니다.

어느 순간 제가 이 마지막 과정을 Claude Code를 열고 하고 있다는 것을 깨달았습니다. 그래서 저는 궁금해지기 시작했습니다. 내가 자리에 앉기도 전에 에이전트가 거기서 시작하면 어떨까?

그 사이드 프로젝트가 PrismaLens가 되었습니다. 재미로 만들었는데, 주로 무언가 고장 났을 때 코딩 에이전트가 스스로 얼마나 멀리 갈 수 있는지 보기 위해서였습니다. 이번 주에 버전 0.5.1을 출시했으니, 이 프로젝트가 무엇을 하는지 그리고 제가 무엇을 배웠는지 알려드리겠습니다.

작동 방식

모니터링 시스템에서 문제가 발생했다고 알리거나(또는 스스로 문제점을 설명하면), PrismaLens는 다음 작업을 수행합니다:

1. 앱 코드의 새롭고 임시적인 복사본을 만듭니다. 실제 폴더는 절대 건드리지 않습니다.
2. 이미 사용하고 있는 코딩 에이전트(Claude Code, Codex 또는 OpenCode)에게 문제를 전달합니다.
3. 에이전트가 코드를 읽고 앱의 메트릭을 확인하도록 합니다.
4. 짧은 보고서를 받습니다: 가장 가능성이 높은 원인들을 나열하며, 각 원인에 대해 에이전트가 찾은 증거를 제시합니다.

에이전트가 한 모든 작업과 그 추론 과정을 문제 옆에 저장해 두기 때문에 사용자가 그 작업을 검토할 수 있습니다.

의도적으로 선택한 몇 가지 사항들

코드를 기반으로 시작한다. 장애 발생을 위한 대부분의 AI 도구는 로그와 대시보드에서 시작합니다. 이들은 무엇이 고장 났는지 알려줍니다. 하지만 코드는 보통 왜 고장 났는지 알려줍니다.

절대 스스로 AI 모델을 호출하지 않는다. 이미 가지고 있는 에이전트를 구동하며, 그 에이전트의 자체 로그인 정보를 사용합니다. 따라서 저에게는 계정 생성, 구독료, 또는 AI 청구서가 발생하지 않습니다.

신뢰도 백분율은 없다.

단 하나의 명령어, 설정 불필요. 사용자의 기기에서 실행됩니다:

npm install -g prismalens
pl up

Docker도 필요 없고, 데이터베이스를 설정할 필요도 없습니다. 브라우저의 localhost:6473에서 열립니다.

구축하며 배운 점

• 에이전트(Agents)는 압박 속에서 코드를 읽는 데 능숙하지만, 모르는 것을 안다고 말하는 것은 서툽니다. "원인을 찾지 못했지만, 제가 확인해 본 내용은 이렇습니다"라는 보고서가 자신감 넘치는 오답보다 더 유용하다는 것을 알게 되어, 이를 허용 가능한 결과로 만들었습니다.
• 권한(Permissions)이 가장 어려운 부분이었습니다. 초기 버전에서는 에이전트 위에 너무 많은 안전 계층을 쌓아 올렸기 때문에, 에이전트가 거의 아무것도 할 수 없었습니다. 0.5.1 버전에서는 에이전트 자체의 권한 모드를 사용하고 그 요청 사항을 보여주는 방식으로 되돌아갔는데, 이는 더 간단하고 신뢰하기 쉽습니다.
• 대부분의 코드는 AI 코딩 에이전트(AI coding agents)를 사용하여 작성되었습니다. 저는 모든 릴리스를 직접 검토하고 테스트하며, 마치 새로운 사용자가 사용하는 것처럼 전체 과정을 따라가 보았습니다. 이 과정 자체가 테스트보다 훨씬 많은 것을 발견하게 해주었습니다.

사용해 보세요

아직 자신의 애플리케이션에 연결하는 것이 부담스럽다면, 레포지토리(repo) 안에 의도적으로 고장 내보고 PrismaLens가 조사하는 모습을 볼 수 있는 작은 데모 앱이 있습니다.

초기 단계입니다 (0.x 버전이며 변경될 예정), 데스크톱 앱은 서명되지 않은 미리보기 버전이며, 현재 Prometheus 스타일 모니터링에 연결됩니다. 이 도구의 성능은 전적으로 사용자의 에이전트와 접근할 수 있는 범위에 달려있습니다.

👉 github.com/prismalens/prismalens

다음번에 무언가 고장 나는 것을 테스트해 보신다면, 무엇을 정확하게 파악했고 무엇을 놓쳤는지 진심으로 듣고 싶습니다.