AGENTS.md (GitHub Copilot 영구 지시어 파일)
Term (용어)aiverifiedFri May 01

AGENTS.md (GitHub Copilot 영구 지시어 파일)

별칭: AGENTS.md · agentsmd · 에이전츠 md

#agents-md#github-copilot#persistent-instructions#design-language

정의

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"

작동 원리

  1. 프로젝트 루트의 AGENTS.md 가 Copilot 세션에 자동 로드.
  2. 다중 에이전트 환경에서 모든 에이전트 가 공유하는 공통 지시어 역할.
  3. 멀티 에이전트 워크플로의 구조 부재 문제를 해결하기 위한 공유 지반.

자매 도구의 등가물

도구영구 지시어 파일
entity/claude-codeterm/claude-md (CLAUDE.md)
entity/cursorterm/cursorrules (.cursorrules)
entity/github-copilotAGENTS.md

강의 활용

주의사항

  • 파일명 대소문자: AGENTS.md (전체 대문자). agents.md / Agents.md 는 불인식.
  • 다중 에이전트 전제: AGENTS.md 는 멀티 에이전트 맥락에서 가장 효과적. 단일 에이전트 사용자에게 다른 두 도구의 등가물 로 비교 제시.
  • 표준 합의: AGENTS.md 표준이 업계 합의된 단일 포맷 인지 시점에 따라 다를 수 있음. 강의 시점(2026-05) 기준으로는 GitHub 주도 사실상 표준 으로 표기.