AI 코딩 도구를 하나만 쓰면 생기는 문제가 있습니다. 그 도구가 쓴 코드를 그 도구가 검사한다는 점입니다. 자기 답안을 자기가 채점하는 셈이라, 테스트가 통과했다고 말해도 정말 통과한 건지 사람이 다시 확인해야 합니다. 저희는 지난 두 달 동안 이 문제를 다른 방식으로 풀어 봤습니다. 도구를 하나 더 똑똑하게 만드는 대신, 세 개를 회사처럼 묶었습니다.
역할을 나누면 검수가 생깁니다
AI DEV DIRECTOR는 Claude Code, OpenAI Codex, Google Antigravity 세 CLI를 각각 HEAD, BUILDER, REVIEWER로 세웁니다. HEAD는 목표를 받아 "어떤 파일을, 몇 개까지, 몇 줄 안에서 고칠지"가 적힌 작업 명세를 만듭니다. BUILDER는 그 명세 안에서만 코드를 씁니다. REVIEWER는 다른 회사 모델이라 BUILDER의 결과를 처음 보는 눈으로 읽습니다. 셋 중 누구도 혼자 통과를 선언하지 못합니다. 테스트가 돌고, 리뷰가 붙고, HEAD가 그 둘을 보고 다음 지시를 내립니다.
역할은 고정이 아닙니다. 콘솔에서 버튼 하나로 바꿀 수 있고, 한 도구의 구독 한도가 끝나면 다음 도구로 자동으로 넘어갑니다. 같은 회사 모델 둘이 HEAD와 REVIEWER를 맡게 되는 순간에는 결과에 "독립성 낮음" 표시가 붙습니다. 숨기지 않습니다.
원본은 건드리지 않습니다
모든 작업은 git worktree로 만든 격리 작업본에서만 일어납니다. 작업 명세에 없는 경로를 쓰려 하면 Scope Guard가 막고, 파일 수와 변경 줄 수 상한도 BUILDER가 풀 수 없습니다. 검증 명령은 프로젝트 안이 아니라 감독관 설정에 두는데, 그래야 BUILDER가 테스트를 약하게 고쳐서 통과시키는 일이 생기지 않기 때문입니다. 테스트와 독립 리뷰를 모두 통과한 결과만 프로젝트에 반영되고, 그 사이 사람이 손댄 파일은 덮어쓰지 않습니다.
어디서 멈추고, 어디서 안 멈추는가
처음에는 조금만 이상해도 사람에게 물었습니다. 그랬더니 25번 중 3번만 끝까지 갔습니다. 나머지 22번은 위험해서가 아니라 마찰 때문에 멈췄습니다. JSON이 깨지거나, 출력 한도에 걸리거나, 리뷰 지적이 하나 남았거나. 그래서 정책을 바꿨습니다. 지금 감독관이 사람에게 묻는 경우는 넷뿐입니다. 결제, 실계좌 주문, 실제 자격증명, 되돌릴 수 없는 외부 행동. 나머지는 재시도하고, 도구를 바꾸고, 다시 계획합니다. 실계좌 주문 코드는 테스트가 그 코드를 실행하기 전에 잡아서 사람에게 넘깁니다.
반대로, 멈추라고 하면 정말 멈춥니다. 이 부분은 저희가 직접 겪고 고쳤습니다. 채팅에 "즉시 작업 중단"이라고 썼는데 HEAD가 말로만 알겠다고 하고 작업은 계속 돈 적이 있었습니다. 지금은 "중단", "멈춰", "stop" 같은 짧은 말이 AI를 거치지 않고 바로 정지 명령이 됩니다. 돌던 프로세스는 자식까지 함께 끊기고, 미션은 정지 상태로 고정돼 재시작해도 이어지지 않습니다. 콘솔에는 "작업 정지"와 "시스템 중지" 버튼이 따로 있습니다.
비용 구조가 다릅니다
종량제 API 키를 쓰지 않습니다. 코드가 환경 변수에서 모든 API 키를 지운 뒤 CLI를 호출하기 때문에, 있어도 못 씁니다. 이미 결제 중인 Claude·Codex·Antigravity 구독 로그인 세션을 그대로 쓰는 구조라, 추가 비용은 0원이고 한도는 각 구독의 한도입니다.
지금 상태
이 코드는 저희가 매일 쓰는 것을 그대로 올린 것입니다. 윈도우 우선이고 콘솔은 한국어입니다. 저장소에는 핵심 코드와 596개의 테스트, 설계 기록이 들어 있고, 테스트는 실제 CLI 없이 스텁으로 돕니다. 큰 변경을 파일 단위 JSON으로 주고받는 한계, 각 구독 한도에 그대로 묶이는 한계는 README에 적어 두었습니다.
필요한 것과 자주 묻는 질문은 AI DEV DIRECTOR 소개 페이지에 정리해 두었습니다.