
1 / 1
【개요】 AGENTS.md는 AI 코딩 에이전트에게 프로젝트 맥락과 지시를 전달하기 위한 단순하고 개방적인 Markdown 형식이다. 사람이 읽는 README가 아니라 에이전트가 읽도록 쓰인 README라고 생각하면 이해가 쉽다. 저장소 안에서 빌드 단계, 테스트, 코딩 관례 같은 정보를 넣어둘 수 있는 일관된 자리가 마련된다. 특정 도구에 종속된 별도 파일 형식을 새로 만드는 대신, 누구나 쓸 수 있는 이름과 형식을 택했다는 점이 특징이다. 이미 60k개 이상의 오픈소스 프로젝트에서 사용되고 있으며, 비용 없이 활용할 수 있다. AI 코딩 에이전트를 쓰거나 만들고 있는 개발자, 오픈소스 프로젝트 메인테이너, 규모가 큰 모노레포를 운영하는 팀에게 적합하다. 【핵심 기능】 • 에이전트 지시 파일 형식: 저장소 안에 빌드 단계, 테스트, 관례 등 에이전트가 참고할 맥락과 지시를 담아두는 전용 위치를 제공한다. • 패키지별 중첩 지시: 큰 모노레포에서는 각 패키지 안에 AGENTS.md를 또 둘 수 있어, 에이전트가 디렉터리 트리에서 가장 가까운 파일을 읽는다. • 테스트 실행 안내: AGENTS.md에 적힌 관련 프로그램 검사를 에이전트가 실행해 보고, 작업을 마치기 전에 실패를 고치도록 유도한다. • 심볼릭 링크로 마이그레이션: 기존 AGENT.md 같은 문서를 심볼릭 링크를 통해 AGENTS.md로 이름을 바꾸면서 하위 호환성을 유지할 수 있다. 【적용 시나리오】 1. AI 코딩 에이전트에게 프로젝트 맥락과 지시를 전달할 때 2. 에이전트를 위해 빌드 및 테스트 명령을 문서화할 때 3. 에이전트가 따를 코드 스타일 가이드라인을 명시할 때 4. 커밋 메시지와 풀 리퀘스트 가이드라인을 제공할 때 5. 모노레포에서 하위 프로젝트마다 맞춤형 지시를 제공할 때 【장점과 단점】 장점: - 도구별 전용 파일이 아니라 개방형 형식이므로, 여러 에이전트 도구를 함께 쓰는 개발자도 저장소마다 같은 파일을 재사용할 수 있다. - 이미 60k개 이상의 오픈소스 프로젝트가 채택한 만큼, 문서 구조를 새로 설계할 필요 없이 관례에 올라탈 수 있다. - 심볼릭 링크 마이그레이션 덕분에 기존 문서 체계를 유지하면서도 점진적으로 옮겨갈 수 있다. 단점: - 패키지별 중첩 지시에서는 편집 중인 파일에 가장 가까운 AGENTS.md가 우선하며, 사용자가 채팅에서 명시한 프롬프트가 모든 것을 덮어쓴다. - 테스트 실행 안내는 해당 테스트 명령을 파일에 직접 적어두어야만 동작한다. 【자주 묻는 질문】 Q: AGENTS.md는 어떤 형식인가요? A: 단순하고 개방적인 Markdown 형식이며, 저장소 안에서 AI 코딩 에이전트에게 프로젝트 맥락과 지시를 전달하는 데 쓰인다. Q: 모노레포에서 패키지마다 다른 지시를 줄 수 있나요? A: 가능하다. 각 패키지 안에 AGENTS.md를 따로 두면 에이전트가 디렉터리 트리에서 가장 가까운 파일을 읽는다. Q: 이미 AGENT.md를 쓰고 있다면 어떻게 옮기나요? A: 기존 문서를 AGENTS.md로 이름을 바꾸고 심볼릭 링크를 활용하면 하위 호환성을 유지하면서 마이그레이션할 수 있다.
free
표시된 가격은 미국 지역 기준가이며, 지역에 따라 다를 수 있습니다.
WPS AI는 WPS Office에 통합된 AI 어시스턴트다. 문서 작성, PPT 구성, 긴 문서 요약, 스프레드시트 수식과 데이터 처리까지 오피스 작업 전반을 AI가 보조한다. 별도의 도구를 오가지 않고 문서…
Baidu Comate는 바이두의 ERNIE 대모델을 기반으로 개발된 AI 코딩 보조 도구다. 자동 코드 생성, 단위 테스트 생성, 주석 생성, 지능형 질의응답 등을 제공해 개발자가 코딩 작업을 더 빠르고 정확하게…
UniConverter는 동영상, 오디오, 이미지를 변환하고 압축, 편집, 개선할 수 있는 AI 미디어 도구다. 특히 AI 비디오 인핸서와 업스케일러를 통해 저화질 영상을 온라인과 데스크톱에서 복원하고 업스케일할…
등록일
2026. 10. 22.
조회수
655
클릭수
1
AGENTS.md 대신 고려해 볼 만한 도구 6건