AGENTS.md 이야기가 흥미로운 이유는 이 파일이 단순히 새 문서 이름을 제안하는 것이 아니라, 에이전트가 프로젝트를 읽는 방식 자체를 표준화하려는 시도 이기 때문입니다. agents.md는 이 포맷을 “README for agents” 라고 설명하는데, 이 표현 하나에 거의 모든 핵심이 들어 있습니다. 사람용 README와 에이전트용 실행 문맥을 분리해 두면, 프로젝트 설명은 깔끔하게 유지하면서도 코딩 에이전트에는 더 구체적인 실행 지침을 안정적으로 줄 수 있습니다.
이 사이트가 설득력 있는 이유는 기능을 과장하기보다, 실제로 어떤 정보가 에이전트에게 필요한지 아주 실무적으로 설명한다는 점입니다. 예를 들어 설정 명령, 테스트 명령, 코드 스타일, PR 규칙, 모노레포 하위 지침, 충돌 우선순위 같은 항목은 사람이 프로젝트 소개 문서에서 늘 보고 싶어 하는 내용은 아니지만, 에이전트가 작업을 끝까지 수행하는 데는 매우 중요합니다. 결국 AGENTS.md는 “문서를 더 하나 만든다” 가 아니라, 사람과 에이전트의 독자층을 분리해 문맥 비용을 줄이는 운영 패턴 에 가깝습니다. agents.md
더보기