AI 코딩 에이전트(AI coding agents)는 컨텍스트 윈도우(context window)와 통계적 사전 확률(statistical priors)의 더미를 바탕으로 추론합니다. 이들은 관습적이고 명시적이며, 지역적으로 읽기 쉬운(locally-readable) 코드에서는 번창하지만, 영리한 간접 참조(indirection), 메타프로그래밍(metaprogramming), 그리고 숨겨진 마법(hidden magic)에는 실패합니다. 영리함이란 당신이 기록하는 것을 잊어버린 컨텍스트(context)입니다. 에이전트가 윈도우 내에서 볼 수 없는 모든 암시적 동작(implicit behavior)은 에이전트가 추측해야 하는 사실이며, 추측은 곧 오류가 발생하는 지점입니다. 코드베이스가 바로 컨텍스트입니다. 지루하고 예측 가능하며, grep(검색) 가능한 아키텍처는 다음 인간 개발자에게 친절할 뿐만 아니라, 에이전트의 성공률을 직접적으로 높여줍니다. 이는 지난 10년간의 "스마트한" 엔지니어링 본능을 뒤집는 것입니다. 2015년에 리뷰어들에게 깊은 인상을 주었던 영리한 추상화(abstraction)는 이제 당신의 처리량(throughput)을 적극적으로 갉아먹고 있습니다. 에이전트의 성공률은 당신이 가질 수 있는 가장 정직한 가독성 지표(legibility metric)입니다. 만약 에이전트가 계속 길을 잃는다면, 당신의 아키텍처가 스스로의 결함을 드러내고 있는 것입니다.