AGENTS.md (GitHub Copilot 영구 지시어 파일)
별칭: AGENTS.md · agentsmd · 에이전츠 md
정의
entity/github-copilot (및 일부 다른 에이전트 도구) 가 채택한 프로젝트별 영구 지시어 파일. 파일명 정확히 AGENTS.md (대문자). term/claude-md / term/cursorrules 와 기능적 등가.
도입 배경
GitHub의 case/github-missing-structure-blog 자체 진단 — 멀티 에이전트 실패 = missing structure — 이후 처방으로 도입. 함께 강화된 기능: term/plan-mode, custom instructions.
GitHub의 자체 측정 결과
AGENTS.md + Plan Mode + custom instructions → "higher quality pull requests"
작동 원리
- 프로젝트 루트의
AGENTS.md가 Copilot 세션에 자동 로드. - 다중 에이전트 환경에서 모든 에이전트 가 공유하는 공통 지시어 역할.
- 멀티 에이전트 워크플로의 구조 부재 문제를 해결하기 위한 공유 지반.
자매 도구의 등가물
| 도구 | 영구 지시어 파일 |
|---|---|
| entity/claude-code | term/claude-md (CLAUDE.md) |
| entity/cursor | term/cursorrules (.cursorrules) |
| entity/github-copilot | AGENTS.md |
강의 활용
- 01 INT case/github-missing-structure-blog: 첫 등장 — missing structure 해결책 으로 언급.
- 04 DSL: AGENTS.md / CLAUDE.md / .cursorrules 비교 슬라이드.
주의사항
- 파일명 대소문자:
AGENTS.md(전체 대문자).agents.md/Agents.md는 불인식. - 다중 에이전트 전제: AGENTS.md 는 멀티 에이전트 맥락에서 가장 효과적. 단일 에이전트 사용자에게 다른 두 도구의 등가물 로 비교 제시.
- 표준 합의: AGENTS.md 표준이 업계 합의된 단일 포맷 인지 시점에 따라 다를 수 있음. 강의 시점(2026-05) 기준으로는 GitHub 주도 사실상 표준 으로 표기.