나무모에 미러 (일반/어두운 화면)
최근 수정 시각 : 2026-02-21 17:20:46

AGENTS.md


<nopad>
{{{#!wiki style="margin: 0 -10px -5px; min-height: calc(1.5em + 5px)"
{{{#!folding [ 펼치기 · 접기 ]
{{{#!wiki style="margin: -5px -1px -11px"
<colbgcolor=#2e3039,#2e3039><colcolor=#fff,#fff> 종류 대화형 인공지능 (주요 목록) · 코드 생성 인공지능 · 그림 인공지능 · 영상 인공지능 · 음향 인공지능 · 3D 모델링· 지능형 에이전트 · VLA · 멀티모달 모델 · 언어 모델 · 월드 모델
프롬프트 프롬프트 · 프롬프트 엔지니어링 · 프롬프트 해킹
아키텍처 트랜스포머 · GAN · 확산 모델 · 변분 오토인코더 · 자기회귀모델
학습 자기지도학습 · 강화학습 (RLHF)
응용 AI 개요 · 인공지능 검색 엔진 · 바이브 코딩(AGENTS.md) · 인공지능 로봇 (테슬라 옵티머스)
문화·밈 AI 커버 · 쇼거스 · 인공지능 버츄얼 유튜버 · ChatGPT 지브리풍 이미지 생성 유행 · 와... 너 정말, **핵심을 찔렀어.**
기타 AI 슬롭 · AI wrapper · 인공지능 환각 · 인공지능 벤치마크 · Model Context Protocol · 대중화 · 인공 일반 지능 · 인공지능 정렬 · Spiritual bliss attractor
}}}}}}}}} ||
1. 개요2. 특징3. 사용법 및 팁4. 지원 소프트웨어
4.1. 미지원 소프트웨어
5. 관련 문서

1. 개요

agents.md

생성형 인공지능, 특히 프로그래밍용 인공지능의 명령 및 컨텍스트 재사용을 위해 코드 저장소에 버전 관리되는 표준화된 파일. 확장자대로 형식은 일반 마크다운과 동일하다.

2. 특징

.gitignore 등 여타 코드베이스 설정용 파일과 마찬가지로 해당 파일이 위치한 폴더 단위 스코프로 적용되며, 여러 하위 폴더가 각각의 AGENTS.md를 가지고 있는 경우 헤당 내용이 중첩되어 컨텍스트로 전달된다. 때문에 모노레포 등 저장소의 최상위 폴더 구조에 따라 코드베이스 도메인이 구분되어 있는 경우 매우 편리하다. 저장소 루트에는 전반적인 커밋 컨벤션을 넣고 백엔드 폴더에는 백엔드 요구사항을, 프런트엔드 폴더에는 프런트 요구사항을 적은 별도의 AGENTS.md 파일을 두어 컨텍스트를 분리하는 식.

사실 비슷한 유형의 설정 파일은 전에도 제품별로 하나씩 있어왔지만 AGENTS.md의 핵심은 이걸 전부 표준화하는 것이다. 가령 전에는 GEMINI.md, CLAUDE.md, .github/copilot-instructions.md 등등 사용하는 소프트웨어별로 각자 표준이 난립해서 한 코드베이스에 여러 회사의 제품을 쓸 경우 문제가 되었으나, 현재는 기업들도 앤트로픽을 제외하면 AGENTS.md 하나로 점차 통일하는 추세이다.

단점으로, AGENTS.md 표준의 경우 어떠한 시맨틱이나 구조 없이 순수 마크다운이기에 별달리 얻을 수 있는 메타데이터가 없다. 보통 개별 제품 특화된 skills, rules 파일이 마크다운 위 frontmatter 영역에 여러 속성이나 제품 특화 메타데이터를 넣고 이를 파싱하는 것과는 대조적. 물론 넣어도 컨텍스트로 읽을 땐 아무 문제가 없어서 큰 상관은 없지만 그러한 기능 자체가 AGENTS.md에서는 표준화되어 있지 않다는 점은 조금 아쉬움이 남는 편이다. 이 때문에 완전히 AGENTS.md하나만으로 100% 전환하기도 어려움이 생기는데, 때문에 현재는 AGENTS.md를 가장 기본적이고 호환성 높은 컨텍스트 파일로 두고 각 제품별 특수 기능은 여전히 유지하거나, 특수 기능에서 AGENTS.md를 일부 참조하는 식의 패턴으로 절충안이 만들어지고 있다.

3. 사용법 및 팁

보통 빌드 명령어 등 글자 단위의 정확도가 필요한 내용이나 커밋 컨벤션 등 에이전트가 한번 해버리면 되돌리기 귀찮은(...) 부분을 루트 스코프에 써두는 게 좋다.

4. 지원 소프트웨어

4.1. 미지원 소프트웨어

5. 관련 문서