AI 코드리뷰를 '강제'하는 게이트 등장

AI에게 코드를 맡기는 시대의 새 고민은 '빨리 짜는 것'이 아니라 '아무도 안 보고 병합되는 것'이다. 이 문제를 프로세스로 푸는 오픈소스가 나왔다. 에이전트킷(agent-kit)은 클로드 코드(Claude Code) 세션이 시작될 때마다 지금 다루는 작업의 크기를 판정하고, 크기에 맞는 필수 검토 단계를 통과했는지 풀리퀘스트(PR)에서 추적하는 워크플로 게이트다.

무슨 일인가

동작 원리는 단순하다. 티켓의 스토리포인트를 기준으로 작업을 S·M·L로 나눈다. 1~2점이면 S, 3~5점이면 M, 8점 이상이면 L이고, 크기를 알 수 없으면 무조건 가장 무거운 L로 올려 잡는다. '모르면 안전한 쪽으로'라는 원칙을 기본값으로 박아 둔 설계다. 세션이 열리면 코드를 건드리기 전에 티켓 번호와 크기, 그에 따른 필수 체인(테스트 → 리뷰 → 문서화 → 오케스트레이션 감사 등)을 먼저 선언하게 만들고, PR에는 봇 댓글로 체인의 각 담당 에이전트가 실제로 흔적을 남겼는지 표시한다.

핵심 짚어보기

무료 코어에는 스크립트 8종과 깃허브 액션 워크플로 2종, 그리고 에이전트 헌장 3종이 들어 있다. 코드 리뷰어, 테스트 엔지니어, 그리고 거부권을 가진 보안·개인정보 담당까지 역할별 인격을 문서로 정의해 두는 방식이다. npm 의존성이 전혀 없이 Node.js 내장 모듈만 쓰고, 자동화 테스트 45개가 무료판 단독으로 통과된다는 점을 문서에서 검증 항목으로 내세웠다. 반면 전체 패키지는 유료다. 에이전트 헌장 11종, 슬래시 명령 7종, 13단계 개발 라이프사이클, 설치 스크립트, 이중언어 템플릿이 유료 쪽에 있다. 핵심 엔진은 공개해 신뢰를 얻고 완성된 운영 체계는 파는 전형적인 오픈코어 수익화 구도로, 개인 개발자의 노하우 상품화 사례로도 읽을 만하다. 무료판은 설치기가 없어 헌장 속 프로젝트 이름 등을 손으로 채워야 하고, 유료판에만 있는 문서를 참조하는 빈 링크가 남는 한계도 솔직하게 명시돼 있다.

1인기업 실전 적용 포인트

• 혼자 개발할수록 리뷰가 생략되기 쉽다. '작업 크기부터 선언하고 시작한다'는 규칙 하나만 자신의 CLAUDE.md에 옮겨 적어도 AI가 큰 변경을 슬쩍 병합하는 사고를 줄일 수 있다.
• 보안 담당 에이전트에게 거부권을 준 구조는 그대로 베낄 만하다. 결제·개인정보를 다루는 코드라면 "보안 검토 에이전트가 통과시키기 전엔 배포 금지" 규칙을 워크플로에 넣자.
• 무료 코어는 저장소에 파일을 복사하고 설정 JSON 하나만 추가하면 동작한다. 외주로 받은 프로젝트에 품질 증빙용으로 붙여 두면 '리뷰 이력'이 PR에 남아 신뢰 자산이 된다.
• 내가 쌓은 자동화 노하우도 이 방식처럼 '엔진은 무료, 완성 패키지는 유료'로 쪼개 팔 수 있는지 검토해 보자.

전망과 주의점

리뷰 체인이 강제되면 속도는 분명히 느려진다. 작은 실험까지 L급 절차를 태우면 배보다 배꼽이 커질 수 있어, 크기 판정 기준을 자기 규모에 맞게 조정하는 게 관건이다. 그럼에도 AI 코딩의 다음 단계가 '생성'이 아니라 '검증의 제도화'로 향하고 있다는 신호로서 의미가 있다.

출처: Hacker News / GitHub (https://github.com/horilla98/agent-kit)