에이전트를 위한 코딩은 따분해야 한다

이런 변화에 따라 저장소의 의미도 변한다. 기존 저장소는 사람이 소스 코드를 보관하고 다른 사람을 위해 약간의 흔적을 남기는 공간이었다. 하지만 이제 저장소는 에이전트를 위한 운영 매뉴얼이 된다. 오픈AI는 코덱스가 처음에는 AGENTS.md 파일로 시작했지만, 거대한 단일 에이전트 매뉴얼은 금세 낡고 쓸모없어지는 문제를 겪었다고 밝혔다. 더 잘 작동한 방식은 AGENTS.md를 구조화된 저장소 내 지식 베이스로 연결하는 짧은 안내 지도로 다루는 것이었다. 이 통찰은 매우 에이전트 친화적이다. 빌드 명령, 테스트 지침, 아키텍처 노트, 설계 문서, 제약 조건, 비목표는 더 이상 부수 문서가 아니다. 이런 요소는 개발 자체를 위한 실행 가능한 맥락의 일부가 되고 있다. 더 직설적으로 말하면 맥락이 이제 인프라가 됐다. 이제 수많은 팀은 자신들의 소프트웨어 개발 프랙티스가 생각보다 훨씬 나빴다는 사실을 곧 깨닫게 될 것이다. 문서화되지 않은 스크립트, 마법처럼 굴러가는 로컬 설정, 불안정한 테스트, 구전 지식에 의존하는 아키텍처, 모호한 티켓, 일관성 없는 이름 붙이기, 그리고 “선임 엔지니어마다 조금씩 다르게 한다”라는 관행이 그렇다. 인간은 그냥 이런 문제를 흡수하며 버텨왔다. 에이전트는 이런 허점을 바로 드러낸다. 불충분하게 정의된 환경은 창의성을 낳지 않는다. 쓰레기를 만든다. 어수선한 코드베이스에 에이전트를 투입했는데 에이전트가 허우적거린다면, 그 장면이 반드시 에이전트에 대한 기소장은 아니다. 많은 경우 그 장면은 팀의 엔지니어링 규율을 매우 효율적으로 감사한 결과이다. 저장소가 마침내 자기 실상을 솔직하게 말해주는 셈이다. 그래서 필자는 AI 코딩이 개발자에게 더 나은 관리자 역할을 요구한다는 기존 제안이 맞지만, 충분하지는 않다고 생각한다. 개발자는 물론 머신을 더 잘 관리하는 사람이 되어야 한다. 하지만 더 중요한 점은 개발자가 전통적 의미에서 더 나은 엔지니어가 되어야 한다는 사실이다. 다시 말해 명세, 경계, 표준 경로, 기타 기본 원칙을 더 잘 다뤄야 한다는 뜻이다. 에이전트 시대는 영리함보다 규율에 훨씬 더 큰 보상을 준다. 그래서 코딩 에이전트의 가장 큰 이야기는 코드를 작성할 수 있다는 점이 아니다. 평범한 챗봇도 이미 그 부분은 그럴듯하게 흉내 낼 수 있다. 가장 큰 이야기는 코딩 에이전트가 유능한 소프트웨어 엔지니어링의 모습을 바꾸고 있다는 점이다. 에이전트는 개발자가 오랫동안 가치 있다고 주장했지만, 실제로는 회피하던 요소에 정확히 보상을 준다. 명시성, 일관성, 테스트 가능성, 그리고 증명이다. 에이전트 시대에는 따분한 소프트웨어 엔지니어링이 더 잘 확장할 뿐 아니라 협업, 디버깅 같은 거의 모든 면에서 더 뛰어나다.