AGENTS.md — 도구가 바뀌어도 남는 맥락

내용

📌 AGENTS.md = 저장소 루트에 두는 도구 중립 규칙 파일

[ 내력 ]
• 2025년 8월 OpenAI가 공개
• 2025년 말 리눅스 재단 산하 Agentic AI Foundation으로 이관
• 2026년 5월 기준 170개 이상 기관 참여, 6만 개 이상 저장소 채택

[ 지원하는 도구 ]
Codex · Jules · Devin · Cursor · Windsurf · VS Code · Zed · Aider 등

⚠️ '지원'의 뜻이 도구마다 다릅니다
• Claude Code — AGENTS.md 를 읽지 않습니다. CLAUDE.md 에서 @AGENTS.md 로 불러와야 합니다
• Gemini CLI — 기본 파일은 GEMINI.md. settings.json 의 context.fileName 을 지정해야 읽습니다
새 도구에서 쓸 때는 '알아서 읽겠지' 하지 말고 한 번 확인하세요.

[ 담는 내용 ]
• 빌드·테스트 명령 (정확한 옵션까지)
• 기본값과 다른 코드 스타일 규칙
• 구조적 제약과 건드리면 안 되는 경계

💡 특정 회사가 관리하지 않아서 파일 이름이 바뀔 걱정이 없습니다.
오늘 AGENTS.md를 만드는 건 한 회사의 로드맵에 베팅하는 게 아닙니다.

📅 2026년 9월 기준