설명
AGENTS.md는 60,000개 이상의 오픈 소스 프로젝트에서 사용되는 코딩 에이전트를 안내하기 위한 간단하고 개방적인 형식입니다. 이를 에이전트를 위한 README로 생각해 보십시오. 전통적인 README.md 파일은 인간 기여자를 위해 맞춤화되어 있으며, 빠른 시작, 프로젝트 설명 및 기여 지침을 제공합니다. AGENTS.md는 빌드 단계, 테스트 및 README를 혼란스럽게 하거나 인간 기여자와 관련이 없는 규칙과 같은 코딩 에이전트가 필요로 하는 추가적이고 때로는 상세한 맥락을 제공함으로써 이를 보완합니다.
AGENTS.md와 README.md의 분리는 여러 가지 목적을 가지고 있습니다. 이는 에이전트에게 지침을 위한 명확하고 예측 가능한 장소를 제공하고, README를 간결하고 인간 기여자에게 집중할 수 있도록 유지하며, 기존 README 및 문서를 보완하는 정확하고 에이전트 중심의 지침을 제공합니다. 또 다른 독점 파일을 도입하는 대신, AGENTS.md는 누구나 사용할 수 있는 이름과 형식을 채택합니다. 코딩 에이전트를 구축하거나 사용하고 이 형식이 유용하다고 생각되면 이를 채택하도록 권장합니다.
하나의 AGENTS.md 파일은 여러 에이전트와 호환되어 개발자에게 다재다능한 도구가 됩니다. 여러분이 생성하는 에이전트 정의는 openai/codex, apache/airflow, temporalio/sdk-java 및 PlutoLang/Pluto를 포함한 AI 코딩 에이전트 및 도구의 성장하는 생태계와 원활하게 작동할 수 있습니다. AGENTS.md를 효과적으로 사용하려면 파일을 프로젝트에 추가하고 에이전트가 효과적으로 작업할 수 있도록 돕는 섹션을 포함하여 중요한 내용을 다루어야 합니다. 이러한 섹션에 대한 인기 있는 선택은 프로젝트 개요, 빌드 및 테스트 명령, 코드 스타일 지침, 테스트 지침 및 보안 고려 사항입니다.
AGENTS.md는 OpenAI Codex, Amp, Google의 Jules, Cursor 및 Factory의 기여를 포함하여 AI 소프트웨어 개발 생태계 전반의 협력 노력에서 탄생했습니다. 이 형식은 이제 Linux 재단의 Agentic AI Foundation에 의해 관리되며, 사용 중인 코딩 에이전트에 관계없이 전체 개발자 커뮤니티에 혜택을 주는 개방형 형식으로 유지하고 발전시키겠다는 약속을 가지고 있습니다.
AGENTS.md의 핵심 기능
개방형 형식
다수의 에이전트와 호환
코딩 에이전트를 위한 상세한 맥락
중첩된 AGENTS.md 파일 지원
프로젝트별 지침 제공
커뮤니티 주도 개발
Agentic AI Foundation에 의해 관리
프로젝트 간 협업 촉진
AGENTS.md 사용 방법은?
AGENTS.md 추가: 프로젝트에 AGENTS.md 파일을 포함합니다.
중요한 내용 다루기: 에이전트가 프로젝트에서 효과적으로 작업할 수 있도록 돕는 섹션을 추가합니다.
추가 지침 추가: 필요에 따라 추가 지침을 제공합니다.
중첩 파일 사용: 대규모 모노레포의 경우 하위 프로젝트를 위한 중첩 AGENTS.md 파일을 구현합니다.
AGENTS.md의 사용 사례
- 프로젝트 문서화
- 오픈 소스 협업
- 에이전트 구성
- 테스트 지침
- 빌드 단계
