AGENTS.md (에이전트용 프로젝트 지침 파일)
AI 용어코딩 에이전트가 읽도록 빌드·테스트·규칙을 적어 두는 저장소 공통 지침 파일.
#개발 워크플로#표준#지침 파일
정의
저장소에 두는 마크다운 파일로, 빌드 방법·테스트 명령·코딩 규칙처럼 에이전트가 작업 전에 알아야 할 내용을 적는다. 사람이 읽는 README와 달리 에이전트용이며, 도구마다 달랐던 지침 파일을 하나로 통일하려는 공개 포맷이다. 현재 리눅스 재단 산하 Agentic AI Foundation이 관리한다.
언제 쓰나
한 저장소에서 여러 코딩 에이전트(Codex, Cursor, Copilot 등)를 함께 쓸 때. 에이전트가 같은 실수를 반복해 규칙을 고정해 둘 필요가 있을 때.
언제 안 쓰나
Claude Code에선
Claude Code의 기본 지침 파일은 CLAUDE.md다. 최신 버전은 CLAUDE.md가 없으면 AGENTS.md를 대신 읽으며, 둘을 같이 쓰려면 CLAUDE.md 안에 @AGENTS.md 한 줄로 가져오면 된다.
예시
AGENTS.md에 "테스트는 pnpm test, 커밋 전 lint 필수" 기재 → 어떤 에이전트를 쓰든 같은 규칙으로 작업.
바로 쓰는 프롬프트
이 저장소를 읽고 AGENTS.md 초안을 써줘. 빌드·테스트 명령, 코드 규칙, 건드리면 안 되는 것만 {{N}}줄 이내로.jt · via term-writer · 복사 0 · KO