AI 코딩 에이전트 팀 도입 전략, 점진적 공개와 하네스 엔지니어링으로 슬롭 줄이기

핵심 메시지

• 코딩 에이전트를 팀에 정착시키는 일은 개별 개발자의 숙련도 문제가 아니라 코드베이스 구조와 공용 설정을 바꿔야 하는 리더십 과제다.
• 각자 알아서 하라고 두면 하루 10개의 PR을 내는 소수와 그 PR을 검토하느라 정작 자기 작업을 못 하는 다수로 팀이 갈라진다.
• 에이전트를 계속 지켜봐야 하거나 간단한 작업에 컨텍스트 50만 토큰을 태우고 있다면 모델이 아니라 코드베이스 설정이 잘못된 신호다.
• 점진적 공개(progressive disclosure), 자가 치유 파이프라인, 지속적인 반복이 발표자가 꼽은 세 가지 핵심 원칙이다.
• 두려움과 활용도라는 두 축으로 팀원의 위치를 파악하고, 회의적인 사람을 설득해 공용 설정을 직접 고치게 만드는 것이 성공 지표다.

쉽게 이해하기

AI 엔지니어 콘퍼런스 무대에 선 아마존 AGI 랩의 아디티야 칸델왈은 코딩 에이전트를 둘러싼 지난 몇 년의 흐름을 먼저 되짚었다. 소수가 압도적인 생산성을 보이자 기업들이 전사 도입을 강제했고, 곧이어 품질 낮은 코드가 대량으로 배포되며 장애가 이어졌다. 모델 가격이 오르면서 예산 통제가 붙었고, 현장에는 회의감이 남았다는 것이다.

그는 이 흐름을 개인 개발자의 관점에서 두 축으로 정리했다. 하나는 '내 일자리가 사라지는가'라는 두려움의 축이고, 다른 하나는 실제로 얼마나 자신 있게 쓰고 있는가라는 활용도의 축이다. 도입 초기에는 두려움이 크고 활용도가 낮았다가, 슬롭이 쏟아지는 시기를 지나면서 두려움은 줄었지만 활용도는 여전히 낮은 지점에 사람들이 몰려 있다고 진단했다.

칸델왈이 제시한 잘못된 설정의 증상은 구체적이다. 에이전트가 도는 동안 계속 지켜보고 있다면, 최신 모델이 오늘따라 멍청하다는 불평이 나온다면, 복잡하지도 않은 작업에 컨텍스트 50만 토큰을 태우고 자동 압축까지 도달한다면 문제는 모델이 아니라 코드베이스에 있다는 것이다. 그는 모델은 그대로인데 하네스가 조금 바뀐 것만으로 결과가 흔들린다면 애초에 설정이 취약했다는 뜻이라고 지적했다.

해법의 출발점은 문제를 개별 기여자(IC)의 몫이 아니라 리더십의 몫으로 재정의하는 것이다. 코드베이스 구조를 바꾸는 일은 개발자 한 명이 할 수 없기 때문이다. 실제 실행 방안으로는 가장 잘하는 팀원의 작업 방식을 찾아내 공용 설정으로 옮기는 기본기, 코드 작성 완료 시점부터 PR 검토 준비 완료까지를 통째로 처리하는 고가치 스킬 하나에 대한 집중 투자, 그리고 이슈·보드·CI를 저장소에 엮어 매일 밤 코드 정리 상태를 점검하는 자동화가 제시됐다.

물론 순탄하지만은 않았다. 몇 주 만에 이슈가 400~500개까지 불어났고, 기대와 다르게 동작하자 다시 에이전트를 지켜보는 방식으로 돌아가려는 사람이 나왔다. 그는 에이전트가 오래 걸리는 것은 오히려 좋은 신호이며, 실험용 프로토타입 코드는 엄격한 기준에서 아예 빼주는 식으로 갈래를 나눠야 한다고 조언했다. 완벽한 설정에는 도달할 수 없다는 사실을 받아들이고 IC 시간의 일정 비율을 계속 여기에 투자하라는 것이 결론이다.

주요 인사이트

• 발표자는 스킬 문서(SKILL.md)에 100줄이라는 상한을 두고, 에이전트가 처음 읽는 문서는 얇은 색인 역할만 하도록 설계했다고 밝혔다. 상세 설명은 해당 코드의 주석에 두어 에이전트가 코드를 찾아 들어갔을 때 자연스럽게 읽히게 만든다.
• 설정이 잘 됐는지 판별하는 실용적인 기준으로 첫 프롬프트에서 소모되는 컨텍스트 양을 제시했다. 기본으로 2만~2만5000 토큰이 잡히는데 4만~5만까지 올라간다면 점진적 공개가 제대로 작동하지 않는 것이다.
• 팀이 도입한 고가치 스킬은 한 시간 넘게 돌아가는 경우가 많았고 그 점이 처음에는 불안감을 줬다. 하지만 결과의 가치를 확인한 뒤에는 오히려 '지켜보지 않아도 된다'는 신뢰의 근거가 됐다.
• 회의적인 팀원을 설득했는지 확인하는 방법은 그들이 공용 설정을 직접 수정하고 만져보는지를 보는 것이다. 단순히 사용하는 것과 설정에 참여하는 것은 다른 수준의 참여다.
• 발표자는 '모델이 멍청하다'는 표현 대신 '어떻게 하면 더 똑똑하게 만들 수 있을까'로 질문을 바꾸라고 권했다. 개인의 설정이 아니라 팀의 공용 설정에 투자한다는 관점 전환이 핵심이다.

자주 묻는 질문

관련 AI 소식