AGENTS.md와 코드 에이전트: 개발자의 새로운 연장

자동완성에서 에이전트로

불과 몇 년 사이, 코드 지원의 성격이 바뀌었습니다: 한 줄씩 제안하던 데서, 코드베이스 전체를 읽고, 테스트를 돌리고, pull request를 여는 에이전트로. 문제는 이제 「코드를 생성하는 것」이 아니라, 에이전트에게 올바른 맥락을 주는 것입니다——빌드 명령, 관례, 아키텍처.

AGENTS.md: Markdown으로 된 오픈 표준

바로 그것을 해결하는 것이 AGENTS.md입니다: 프로젝트 루트에 두는 단순한 Markdown 파일로, 어떤 에이전트에게든 여기서 일하는 방법을 설명합니다——빌드와 테스트 명령, 코드 스타일, 프레임워크, 아키텍처 결정. 강요된 스키마도, 설치할 도구도 없습니다: 그것을 읽는 모든 에이전트가 즉시 혜택을 봅니다.

이 형식은 2025년 8월에 공식화되었고, 이어 2025년 12월 Linux Foundation의 Agentic AI Foundation에 기증되었습니다. 2025년 말까지 6만 개가 넘는 오픈소스 프로젝트가 채택했고, 스무 개가 넘는 도구가 지원합니다——GitHub Copilot(2025년 8월부터 네이티브 지원), OpenAI Codex, Cursor, Gemini와 Jules, Windsurf, Zed, 그 외. 시대의 신호: Next.js 16.2는 이제 create-next-app에서 AGENTS.md를 생성합니다.

왜 한때의 유행 이상인가

맥락이 없는 에이전트는 매번 프로젝트를 처음부터 다시 발견합니다: 명령을 추측하고, 당신의 관례를 무시하며, 다시 손봐야 할 코드를 만들어 냅니다. 잘 쓰인 AGENTS.md는 그 발견 단계를 없앱니다: 생성된 코드는 처음부터 당신의 표준을 따르고, 리뷰의 왕복이 줄어듭니다.

따지고 보면 좋은 온보딩 문서와 같은 발상입니다——다만 여기서 새로 온 이는 빠르게 읽고 아무것도 잊지 않는 기계일 뿐입니다.

나의 입장

저는 자주 말합니다: AI는 제 도구의 일부일 뿐, 토대가 아닙니다. 잘 갖춰진 에이전트는 리서치, 프로토타이핑, 기계적인 작업을 앞당깁니다. 하지만 AGENTS.md를 쓰고, 아키텍처를 정하고, 검토하고 확정하는 것은 개발자입니다. 도구는 판단을 대체하지 않습니다: 판단을 증폭합니다.

에이전트는 당신이 주는 맥락만큼 유능합니다. AGENTS.md는 그 맥락을, 코드와 함께 버전 관리한 것입니다.