에이전트 정책 파일은 시스템 프롬프트를 대신하지 않는다
AGENTS.md 같은 저장소 정책 파일은 프로젝트별 명령, 금지 경로, 검증 기준을 리뷰 가능한 파일로 끌어낸다. 하지만 보안 경계가 아니며, 길고 일반적인 규칙 덩어리는 오히려 비용과 실패를 늘릴 수 있다.
주시
영향도 78 / 100
이벤트 2026-02-23
출처 3개 (주근거 1)
핵심 요약
- 2026-02-23 arXiv 논문은 저장소 수준 문맥 파일이 항상 성능을 높이지 않으며 비용과 실패를 늘릴 수 있음을 평가했다.
- OpenAI 문서는 Codex가 작업 전 AGENTS.md를 읽고 프로젝트 지침을 계층화한다고 설명한다.
- 정책 파일은 에이전트 지침을 코드 리뷰 가능한 위치에 두지만, 실제 통제는 샌드박스, 권한, 승인, 검증 명령과 함께 작동해야 한다.
맥락
- 시스템 프롬프트는 제품 기본 행동을 정하지만 저장소별 금지 파일, 테스트 명령, 배포 경계는 계속 바뀐다.
- AGENTS.md는 그 변화를 에이전트가 읽을 수 있는 운영 문서로 옮기는 장치다.
판단 근거
- arXiv 논문은 2026-02-23 날짜와 저장소 문맥 파일의 비용 및 성공률 영향 평가를 제공한다.
- OpenAI Codex 문서는 AGENTS.md 읽기와 지침 계층화를 공식 사용 방식으로 설명한다.
- GitHub 글은 좋은 agents.md가 명령, 경계, 예시를 짧게 담아야 한다는 실무 기준을 제공한다.
근거 해석
arXiv 평가, OpenAI Codex 문서, GitHub 작성 가이드가 정책 파일의 유용성과 한계를 함께 확인한다.
비교 축
- 시스템 프롬프트 vs 저장소 정책 파일
- 사람용 README vs 에이전트용 지침
- 긴 규칙 덤프 vs 짧은 검증 기준
- 지침 파일 vs 하드 샌드박스
추천
AGENTS.md는 짧고 구체적인 프로젝트 규칙과 검증 명령만 담아라. 민감 작업은 파일 지침이 아니라 권한 제한과 사람 승인으로 막아야 한다.
위험
- 보안 경계로 오해
- 장문 규칙으로 인한 비용 증가
- 오래된 명령
- 자동 생성 일반론이 실제 팀 규칙을 가릴 위험
출처
-
2026-02-23 저장소 수준 문맥 파일의 효과와 비용을 평가한 논문 날짜 확인 자료
https://arxiv.org/abs/2602.11988 -
Codex가 AGENTS.md를 읽고 프로젝트별 지침을 계층화한다는 공식 사용 방식 확인 자료
https://developers.openai.com/codex/guides/agents-md -
저장소 지침 파일에 명령, 경계, 예시를 담는 실무 구조 확인 자료
https://github.blog/ai-and-ml/github-copilot/how-to-write-a-great-agents-md-lessons-from-over-2500-repositories/