AI가 엔지니어 전부인 오픈소스 PR 검토기 IntentGuard를 Claude로 만든 경험기

작성자는 저장소 링크와 플레이그라운드를 공개했고 후속 포스트에서 사용할 프롬프트와 스펙 문서를 공유할 의사를 표명했다. 게시물 자체에는 댓글 요약이 포함되어 있지 않지만 공개 코드와 즉시 실험 가능한 플레이그라운드가 함께 제공되어 실무자들이 직접 검증할 수 있는 환경을 마련했다. 이러한 공개성은 재현 가능성과 추가 검증을 용이하게 한다.

• PR 콘텐츠를 외부 공격자가 제어하는 입력으로 가정해 설계하면 공격 표면을 줄일 수 있다. 구체적으로 코드 체크아웃을 금지하고 pull_request_target 이벤트를 쓰지 않으며 입력 구분자와 시크릿 마스킹을 도입하면 모델에게 전달되는 정보량과 위험을 통제할 수 있다. 또한 모델 출력을 엄격한 JSON 스키마에 매핑하고 검사 실패 시 단일 교정 재시도를 적용함으로써 불확실한 출력을 운영 가능 수준으로 끌어올릴 수 있다.
• API 의존성을 최소화하기 위해 오프라인 모드나 API 키 없이 실행 가능한 테스트 스위트를 먼저 마련하면 개발 초기 단계에서 반복 검증이 쉬워진다. 브라우저 자동화가 실패하는 경우에는 자동 클릭 대신 폼을 미리 채워 인간이 마지막 제출을 하는 하이브리드 워크플로를 적용하는 것이 현실적인 대비책이다. 인증 관련 단계는 가능한 범위에서 토큰 교환을 사람 주도 프로세스로 유지하고 자동화 레벨을 점진적으로 높이는 것이 안전하다.

GitHub Actions

— 소스 코드 변경 사항에 따라 자동 작업을 실행하는 CI/CD 워크플로 도구로서, 리포지토리 이벤트(예: pull_request)에 반응해 스크립트·검증·배포를 수행하며 이 프로젝트에서는 PR 리뷰 자동화를 트리거하는 런타임으로 사용됐다.

Zod

— 타입 안전성을 제공하는 런타임 스키마 검증 라이브러리로서 JSON 입력을 선언적 스키마와 대조해 유효성 검사하고 이 프로젝트에서는 모델 출력을 엄격한 JSON 스키마와 대응시키는 검증층으로 활용됐다.

pull_request_target

— GitHub Actions의 이벤트 유형 가운데 하나로서 타깃 브랜치 컨텍스트에서 워크플로를 실행해 권한과 시크릿 접근권이 달라 보안상 위험을 유발할 수 있으며, 이 글에서는 이를 사용하지 않는 설계 선택으로 공격 표면을 축소했다.