AGENTS.md 작성 가이드와 최신 AI 모델 업데이트 (GPT-5.4 mini, MiniMax-M2.7)

섹션별 상세

AGENTS.md와 CLAUDE.md는 에이전트가 대화를 시작하기 전 참조하는 지침 파일로, 시스템 프롬프트에 사용자의 특정 요구사항을 추가하여 에이전트의 행동을 제어한다.

text

my-project/
├── AGENTS.md ← root instructions (always loaded)
└── docs/
    └── AGENTS.md ← loaded when agent works in /docs

프로젝트 폴더 구조에 따른 AGENTS.md 파일의 계층적 로드 방식 예시

최근 연구에 따르면 AGENTS.md에 기술 스택이나 파일 구조를 상세히 적는 것은 에이전트의 성능을 저하시키고 토큰 비용을 20% 증가시키므로, 에이전트가 스스로 파악하기 어려운 개인적 선호도 위주로 작성해야 한다.

구글이 발표한 Stitch는 Gemini 기반의 UI 디자인 파트너로, AI 네이티브 캔버스와 디자인 에이전트 기능을 통해 즉각적인 프로토타입 생성과 디자인 시스템 관리를 지원한다.

OpenAI는 Sonnet 4.6 수준의 성능을 갖추면서도 속도는 3배 빠르고 비용은 70% 저렴한 GPT-5.4 mini 모델을 출시하여 효율적인 AI 도입을 가능하게 했다.

MiniMax-M2.7 모델은 자가 진화 기술을 통해 개발되었으며, SWE-bench Pro에서 56.22%의 성능을 기록하며 소프트웨어 엔지니어링 분야에서 최상위권의 역량을 입증했다.

arXiv용 MCP(Model Context Protocol)와 Cursor의 커뮤니티 플러그인 디렉토리가 공개되어 연구 및 개발 에이전트가 외부 도구와 지식을 더 쉽게 활용할 수 있는 환경이 구축되었다.

에이전트 지침 파일(AGENTS.md): — 에이전트가 작업을 시작하기 전 참조하는 설정 파일로, 사용자의 선호도나 특정 도구 사용 규칙을 정의하여 에이전트의 행동을 일관되게 유지하는 역할을 한다. 시스템 프롬프트에 추가되어 에이전트의 기본 동작을 제어하는 데 중요하게 사용된다.
소프트웨어 엔지니어링 벤치마크 프로(SWE-bench Pro): — 실제 오픈소스 프로젝트의 복잡한 이슈를 AI가 얼마나 잘 해결하는지 측정하는 성능 지표이다. 단순한 코드 작성을 넘어 실제 환경에서의 버그 수정 및 기능 구현 능력을 평가하여 모델의 실질적인 개발 역량을 보여준다.
모델 컨텍스트 프로토콜(MCP): — AI 모델이 외부 도구, 데이터베이스, 또는 실시간 데이터 소스와 표준화된 방식으로 상호작용할 수 있도록 설계된 개방형 프로토콜이다. 이를 통해 에이전트는 arXiv 논문 검색이나 로컬 파일 접근 등 다양한 기능을 확장하여 수행할 수 있다.

text

my-project/
├── AGENTS.md ← root instructions (always loaded)
└── docs/
    └── AGENTS.md ← loaded when agent works in /docs

프로젝트 폴더 구조에 따른 AGENTS.md 파일의 계층적 로드 방식 예시

OpenAI는 Sonnet 4.6 수준의 성능을 갖추면서도 속도는 3배 빠르고 비용은 70% 저렴한 GPT-5.4 mini 모델을 출시하여 효율적인 AI 도입을 가능하게 했다.

에이전트 지침 파일(AGENTS.md): — 에이전트가 작업을 시작하기 전 참조하는 설정 파일로, 사용자의 선호도나 특정 도구 사용 규칙을 정의하여 에이전트의 행동을 일관되게 유지하는 역할을 한다. 시스템 프롬프트에 추가되어 에이전트의 기본 동작을 제어하는 데 중요하게 사용된다.
소프트웨어 엔지니어링 벤치마크 프로(SWE-bench Pro): — 실제 오픈소스 프로젝트의 복잡한 이슈를 AI가 얼마나 잘 해결하는지 측정하는 성능 지표이다. 단순한 코드 작성을 넘어 실제 환경에서의 버그 수정 및 기능 구현 능력을 평가하여 모델의 실질적인 개발 역량을 보여준다.
모델 컨텍스트 프로토콜(MCP): — AI 모델이 외부 도구, 데이터베이스, 또는 실시간 데이터 소스와 표준화된 방식으로 상호작용할 수 있도록 설계된 개방형 프로토콜이다. 이를 통해 에이전트는 arXiv 논문 검색이나 로컬 파일 접근 등 다양한 기능을 확장하여 수행할 수 있다.