AI가 쓴 코드, 커밋마다 증거 남긴다

AI 코딩 에이전트가 만든 코드를 어디부터 검토해야 할지 알려주는 오픈소스 도구가 나왔다. 깃허브에 공개된 도큇(Docket)은 에이전트의 작업 과정을 커밋마다 '증거 기록'으로 남겨, 검증 흔적이 없는 줄에 리뷰어의 시선이 가도록 설계됐다. 아파치 2.0 라이선스로 배포된다.

무슨 일인가 / 배경

코딩 에이전트는 사람이 검증하는 속도보다 훨씬 빠르게 코드를 만든다. 문제는 리뷰어가 받는 것이 완성된 변경분(diff)뿐이라는 점이다. 에이전트가 처음에 무엇을 시도했고, 어떤 테스트를 돌렸고, 어느 줄은 아무도 확인하지 않았는지 같은 과정 정보는 커밋 순간 사라진다.

도큇 개발자는 이 과정 정보가 에이전트 실행 환경에서 이미 생성되고 있는데 버려지고 있다고 봤다. 도큇은 그 기록을 붙잡아 실제 변경분과 맞춰 접고, 코드 조각(hunk) 단위로 증거 기록을 만든다.

핵심 짚어보기

docket show HEAD를 실행하면 커밋에 대한 요약이 나온다. 추가된 줄 중 몇 퍼센트가 기록된 편집에서 왔는지, 조각별 '증거 밀도'가 얼마인지, 어떤 에이전트와 모델이 어떤 의도로 수정했는지가 표시된다. 한 번 실패한 시도는 폐기된 시도로 따로 남고, 테스트 실행 결과와 커버리지 수치, 그리고 사람이 그 줄을 본 기록이 있는지도 함께 보여준다.

운영 방식도 가볍다. 계정도 네트워크도 필요 없고, 기록은 저장소 안의 별도 참조(orphan ref)에 보관된다. 설치는 단일 실행 파일 하나이며 맥·리눅스·윈도우를 지원하고, 릴리스마다 체크섬을 함께 제공한다. 기록에는 서명과 해시 검증 정보도 붙는다.

이 도구가 던지는 질문은 본질적이다. AI 코드 리뷰의 병목은 '읽는 속도'가 아니라 '어디를 읽어야 하는지 모르는 것'이다. 도큇은 검증된 곳과 아닌 곳을 구분해 주의력을 배분하는 쪽으로 문제를 재정의했다.

1인기업 실전 적용 포인트

• 데모부터 돌려보기: 저장소의 scripts/demo.sh는 임시 폴더에 가짜 저장소를 만들어 에이전트가 버그를 한 번 틀리고 고치는 과정을 재현한 뒤 삭제한다. 내 프로젝트를 건드리지 않고 10분 안에 출력 형태를 확인할 수 있다.
• '사람 확인 없음' 줄만 골라 리뷰: 혼자 운영하는 서비스라면 모든 diff를 정독하기 어렵다. 결제·인증·개인정보 처리 파일에서 테스트 증거가 없고 사람 확인 기록도 없는 조각만 우선 검토하는 규칙을 세우자.
• 외주·고객 납품 시 검증 근거로 활용: AI로 개발한 결과물을 납품할 때 커밋별 테스트 통과 기록을 함께 보여주면 "AI가 대충 만든 것 아니냐"는 우려에 구체적으로 답할 수 있다.
• CI에 단계적으로 도입: 처음엔 기록만 쌓고, 익숙해지면 증거 밀도가 낮은 커밋에 경고를 띄우는 식으로 점진 적용하라. 버전은 태그로 고정해 예기치 않은 업데이트를 막는 것이 좋다.

전망 / 주의점

도큇은 공개 초기 단계로, 확인 시점 기준 커밋 13개·스타 13개 수준의 작은 프로젝트다. 기록의 신뢰 수준도 로컬에서 서명된 '자기 신고'에 가깝다는 점을 감안해야 한다. 에이전트 실행 환경이 보고하는 정보에 의존하므로, 지원 범위 밖의 도구로 작업한 코드는 기록이 비어 있을 수 있다.

그럼에도 방향은 주목할 만하다. 코드 생성이 거의 공짜가 되면서 검증의 흔적 자체가 품질의 증거로 거래되는 시대가 오고 있다. AI로 제품을 만드는 1인기업이라면 지금부터 '무엇을 확인했는지'를 남기는 습관이 경쟁력이 된다.

출처: GitHub (https://github.com/Dillonsmart/docket)