# AGENTS.md

> 출처: https://retn.kr/glossary/agents-md/ · 수정 2026-10-26 · 리텐션 주식회사

**정의:** 여러 AI 코딩 에이전트가 공통으로 읽는 저장소의 지침 파일로, 에이전트용 README 역할을 한다.

## 실무에서 뜻하는 것

AGENTS.md는 사람용 README와 따로 두는 AI 에이전트용 작업 설명서입니다. 빌드·테스트 명령, 코드 규칙, 하지 말아야 할 일을 적습니다. 파일은 저장소 루트에 둡니다. 하위 프로젝트마다 별도 파일을 둘 수 있고, 작업 위치에 가장 가까운 파일이 우선합니다. [[codex]], Cursor, Gemini CLI, GitHub Copilot 같은 도구가 이 형식을 읽습니다. 관리는 Linux Foundation 산하 Agentic AI Foundation이 맡습니다.

## 리텐션에서 쓴 예

[GPT-5.4/Codex 프롬프트 구조](/blog/codex-prompting-guide-vs-claude-code/) 글은 Codex 프로젝트 루트에 AGENTS.md를 두라고 권했습니다. 예시 파일에는 규칙 네 줄을 적었습니다. 작업은 끝까지 마칠 것, 꼭 필요할 때만 질문할 것, 완료 전에 테스트를 돌릴 것, 동작하는 전체 코드를 낼 것입니다. 글은 이 파일이 없으면 세션마다 같은 규칙을 프롬프트에 다시 넣어야 한다고 적었습니다.

## 헷갈리기 쉬운 것

[[claude-md]]는 Claude Code 전용 지침 파일입니다. 2026-10 기준 Claude Code는 기본 설정에서 CLAUDE.md가 없을 때만 AGENTS.md를 읽습니다. 두 파일을 함께 쓰려면 CLAUDE.md 첫 줄에 `@AGENTS.md`를 넣어 가져옵니다.