코드베이스의 주요 기여자가 인간에서 AI 에이전트로 바뀌고 있다면, 문서화의 대상 역시 바뀌어야 한다. AGENTS.md의 등장은 단순한 유행이 아니라, 소프트웨어 생태계의 지각변동을 상징한다. 이제 문서는 ‘인간의 학습’을 돕는 보조 자료를 넘어, ‘AI의 성공적 실행’을 강제하는 ‘제어 신호’가 되고 있다.
취향이 있는 엔지니어는 문서의 독자가 바뀌었음을 즉각적으로 감지하고 형식을 적응시킨다. AI에게 코드베이스 탐색법, 테스트 명령 실행 방식, 표준 준수 규칙을 직접적으로 명시하는 행위는, 에이전트가 헤매지 않고 ‘필연적으로’ 성공하게 만드는 고도의 시스템 설계다. 이는 커뮤니케이션 능력이 코딩 능력을 압도하는 AI 시대의 전형적인 사례다.
근거
OpenAI Codex 팀은 문서의 독자 설정을 아예 에이전트로 명시함으로써 협업 효율을 극대화했다.
“AGENTS.md 파일은 인간이 아닌 AI 에이전트용 README다. 문서의 독자가 바뀌었음을 인식하고 형식을 적응시킨 커뮤니케이션 취향의 산물이다.”
연결된 생각
- 20260611-software-engineering-taste — 커뮤니케이션과 스토리텔링 영역에서의 취향 발현
- 20260605-your-ai-agent-broke — 에이전트의 실패를 방지하기 위한 구조적 가이드의 필요성