AGENTS.md

케이스 1OpenAI 코덱스 등 공동 제정(미국) — 도구를 가리지 않는 공통 규격

2025년 OpenAI 코덱스, 앰프(Amp), 구글 줄스, 커서, 팩토리가 함께 AGENTS.md 형식을 공개했습니다 ^[1][2]. 정해진 항목 없이 자유로운 마크다운으로 쓰되, 위치와 이름을 통일해 어느 에이전트든 읽게 했습니다 ^[1]. README가 사람용이라면 AGENTS.md는 에이전트용 안내서입니다.
도입효과: 오픈소스 프로젝트 6만 개 이상 사용, 지원 도구 25종 이상(공식 사이트 기준) ^[1]

케이스 2리눅스재단(미국) — 중립 재단이 관리하는 표준으로

AGENTS.md는 리눅스재단 산하 에이전틱 AI 재단이 스튜어드로 관리합니다 ^[1]. 특정 회사 소유가 아닌 중립 규격이 되면서 경쟁 관계의 코딩 에이전트들이 같은 파일을 지원할 명분이 생겼습니다 ^[1][2]. 도구마다 다른 지침 파일로 갈라지던 파편화를 줄인 사례입니다.
도입효과: 공동 제정사 외 도구까지 지원 확대(공식 사이트 목록 기준) ^[1]

케이스 3깃허브(미국) — 2,500개 저장소 분석으로 뽑은 작성 원칙

깃허브는 2025년 11월 AGENTS.md를 쓰는 2,500개 이상 저장소를 분석해 작성 가이드를 공개했습니다 ^[3]. 명령어는 복사해 바로 실행할 수 있게, 규칙은 코드 예시와 함께 구체적으로 쓰라는 것이 핵심입니다 ^[3]. 깃허브 코파일럿 코딩 에이전트도 이 파일을 읽습니다 ^[3].
도입효과: 2,500개 이상 저장소 분석 기반 모범 작성 패턴 정리(깃허브 공식 블로그 기준) ^[3]

케이스 4국내 개발자 커뮤니티(한국) — 한국어 가이드 확산

국내에서도 파이토치 한국 커뮤니티와 개발 블로그를 중심으로 AGENTS.md 소개와 작성법이 공유되고 있습니다 ^[4][5]. CLAUDE.md 등 도구별 파일과의 관계를 정리한 한국어 해설도 이어집니다 ^[5]. 코딩 에이전트를 도입한 팀의 온보딩 문서로 자리 잡는 중입니다.
도입효과: 한국어 소개·작성 가이드 다수 공개(커뮤니티 기준) ^[4][5]

오늘 바로 해보기
01. 팀 저장소 최상위에 AGENTS.md 파일을 만들고 설치·빌드·테스트 명령 세 가지부터 적습니다 ^[1].
02. 공식 사이트의 예시 파일을 열어 프로젝트에 맞는 섹션을 고릅니다 ^[1].
03. 깃허브 작성 가이드에서 명령어를 복사 가능한 코드블록으로 쓰는 원칙을 확인합니다 ^[3].
04. 사용 중인 코딩 에이전트가 AGENTS.md를 지원하는지 도구 목록에서 확인합니다 ^[1].
05. 모노레포라면 하위 폴더별 AGENTS.md로 패키지 규칙을 분리합니다 ^[3].

한계와 진화
한계는 유지보수와 실효성입니다. 코드가 바뀌었는데 안내문이 낡으면 에이전트가 틀린 절차를 따르게 되므로, 코드 리뷰에 AGENTS.md 갱신을 포함하는 운영 규율이 필요합니다. 파일이 지나치게 길면 그 자체가 컨텍스트를 잡아먹는 부담이 되기도 합니다.
진화는 에이전트 운영 체계의 문서화입니다. 도구별로 흩어져 있던 지침 파일이 공통 규격으로 수렴했고, 재단 관리 체제에서 명세가 정비되고 있습니다 ^[1]. 코딩을 넘어 일반 업무 에이전트에도 프로젝트 맥락 파일을 두는 관행이 확산될지가 다음 관전 포인트입니다.