AGENTS.md 완벽 입문 가이드: 6만 개 리포지토리가 채택한 사실상의 표준(De Facto Standard) 포맷

OpenAI가 2025년 8월 공개한 'AGENTS.md'는 6만 개 이상의 리포지토리에 채택되며 AI 코딩 에이전트 설정을 위한 사실상의 표준(De Facto Standard)으로 자리 잡았습니다. 이 포맷은 도구별로 파편화된 설정 파일 문제를 해결하기 위해 Linux Foundation 산하 Agentic AI Foundation(AAIF)의 공식 프로젝트로 채택되어 관리되고 있습니다.

AI 요약

AI 코딩 에이전트의 확산으로 Claude Code(CLAUDE.md), Cursor(.cursorrules), GitHub Copilot 등 도구마다 서로 다른 설정 파일을 요구함에 따라 개발자들의 관리 부담이 급증했습니다. 이러한 문제를 해결하기 위해 2025년 8월 OpenAI가 제안한 'AGENTS.md'는 하나의 Markdown 파일에 코딩 규약, 빌드 명령, 금지 사항 등을 작성하면 다양한 에이전트가 이를 공통으로 읽어 들일 수 있도록 설계된 오픈 포맷입니다. 2025년 12월, Linux Foundation 산하의 'Agentic AI Foundation(AAIF)'이 출범하며 이를 창설 프로젝트 중 하나로 채택하였고, 현재 60,000개 이상의 리포지토리가 이 표준을 따르고 있습니다. Microsoft, Google, Anthropic 등 글로벌 빅테크 기업들이 참여하는 AAIF의 지원 덕분에 단순한 제안을 넘어 산업 표준으로서의 신뢰성을 확보하게 되었습니다.

핵심 인사이트

  • 폭발적인 채택률: 현재 60,000개 이상의 리포지토리가 AGENTS.md를 도입하여 사용 중입니다.
  • 공식 표준화: 2025년 12월, Linux Foundation의 Agentic AI Foundation(AAIF) 창설 프로젝트로 정식 채택되었습니다.
  • 3대 핵심 프로젝트: AAIF는 Anthropic의 MCP(Model Context Protocol), Block의 goose와 함께 OpenAI의 AGENTS.md를 3대 주요 프로젝트로 관리합니다.
  • 강력한 파트너십: AWS, Anthropic, Microsoft, Google, OpenAI 등 주요 기업들이 AAIF의 플래티넘 멤버로 참여하여 에코시스템을 구축하고 있습니다.

주요 디테일

  • 도구별 대응 현황: OpenAI Codex CLI는 네이티브 지원(32KiB 상한)을 하며, Cursor(v1.5)는 루트 디렉토리 파일을 인식하고, GitHub Copilot은 리포지토리 지침으로 이를 읽어들입니다.
  • 기술 사양: 표준 Markdown 형식을 따르며 UTF-8 인코딩을 권장합니다. MIT 라이선스로 배포되며 리포지토리 루트 및 서브디렉토리에 배치가 가능합니다.
  • 도입 배경: 각기 다른 설정 파일(.cursorrules, CLAUDE.md 등)을 동기화하는 '설정 파편화'와 그로 인한 '지침 불일치' 문제를 해결하기 위해 탄생했습니다.
  • 편의성: 별도의 스키마 학습이나 도구 설치 없이 기존 README를 작성하듯 Markdown으로 작성하면 되므로 도입 장벽이 매우 낮습니다.
  • 확장성: GitLab Duo 등 주요 Git 플랫폼들도 AGENTS.md 지원을 발표하며 지원 범위를 넓히고 있습니다.

향후 전망

  • 범용 에이전트 표준화: 특정 도구에 종속되지 않는 AGENTS.md가 확산됨에 따라 개발 환경 구축의 자동화와 효율성이 비약적으로 상승할 전망입니다.
  • 에코시스템 통합: AAIF 주도의 표준화 활동을 통해 서로 다른 AI 에이전트 간의 상호 운용성이 강화되어 '멀티 에이전트' 협업 환경이 가속화될 것으로 보입니다.
Share

이것도 읽어보세요

댓글

이 소식에 대한 의견을 자유롭게 남겨주세요.

댓글 (0)

불러오는 중...