본문으로 건너뛰기
ReviewRamble

주간 브리프

AI 리뷰를 받은편지함으로.

  • 도구, 모델, MCP 서버, 저장소의 새 리뷰(결론부터)
  • 변경이 있을 때 다시 확인한 가격과 평점
  • 새로 발행된 분석 글

모델, 에이전트, MCP 서버, 그리고 정말 시간을 들일 만한 도구.

일주일에 한 통입니다. 각 브리프의 링크로 구독을 해지할 수 있습니다. 이메일 사용 방식

에이전트 지침 파일(AGENTS.md)

에이전트 지침 파일(agent instructions file)은 AGENTS.md나 CLAUDE.md처럼 코드 저장소 안에 두는 Markdown 파일로, 코딩 에이전트가 세션을 시작할 때 읽어 프로젝트의 명령, 관례, 규칙을 익힙니다.

다른 이름: AGENTS.md, CLAUDE.md, .cursorrules, rules file

작성 Divya Sharma · 2026년 11월 15일 확인 · 리뷰 방식

코딩 에이전트는 세션을 시작할 때마다 프로젝트에 대해 아무것도 모릅니다. 도움이 없으면 테스트를 어떻게 실행하는지, 어떤 스타일을 따르는지, 어떤 폴더를 건드리지 말아야 하는지 추측합니다. 지침 파일은 에이전트가 항상 읽는 곳에서 그 질문들에 한 번에 답합니다.

흔한 형식

AGENTS.md는 여러 도구에서 동작하도록 만든 개방형 형식으로, OpenAI Codex를 비롯한 많은 도구가 읽습니다. Claude Code는 CLAUDE.md를 읽으며 AGENTS.md도 쓸 수 있습니다. Cursor에는 이전의 .cursorrules를 포함한 자체 규칙 파일이 있습니다. 내용은 어디서나 비슷합니다. 빌드와 테스트 명령, 코드 스타일, 구조에 관한 메모, 하지 말아야 할 일입니다.

작동 방식

에이전트는 세션을 시작할 때 파일을 컨텍스트에 불러오므로, 이 파일은 프로젝트 단위의 시스템 프롬프트처럼 작동합니다. 파일은 중첩할 수 있습니다. 모노레포라면 루트에 하나, 각 패키지에 하나씩 둘 수 있고, AGENTS.md 지침에 따르면 수정 중인 코드에 가장 가까운 파일이 우선하며, 채팅에 입력한 지시는 그 모두보다 우선합니다. 홈 폴더의 개인 파일에는 모든 프로젝트에 적용할 규칙을 둘 수 있습니다.

한계

이 파일은 컨텍스트일 뿐 강제 수단이 아닙니다. 에이전트는 대개 따르지만, 특히 컨텍스트 압축 뒤에는 무시하거나 잊을 수 있습니다. 운영 설정을 절대 건드리지 않기처럼 항상 지켜야 하는 규칙은 에이전트 훅이나 권한 설정에 두어야 합니다. 파일은 짧고 구체적으로 유지하십시오. 긴 파일은 세션마다 토큰을 쓰고 중요한 규칙을 희석합니다. 재사용할 절차는 에이전트 스킬에 두는 편이 낫습니다.

관련 용어

코딩 에이전트
코딩 에이전트(coding agent)는 소프트웨어를 직접 다루는 AI 에이전트입니다. 사람이 붙여 넣을 코드를 제안하는 데 그치지 않고, 코드베이스를 읽고, 파일을 수정하고, 명령과 테스트를 실행하며, 변경이 동작할 때까지 반복합니다.
컨텍스트 엔지니어링
컨텍스트 엔지니어링(context engineering)은 작업 동안 언어 모델의 컨텍스트 윈도에 들어가는 모든 것을 고르고 관리하는 일입니다. 지시, 검색한 문서, 도구 정의, 도구 결과, 대화 기록이 여기에 포함됩니다.
에이전트 스킬
에이전트 스킬(agent skills)은 지시, 스크립트, 참고 파일을 담은 폴더로, 각각 SKILL.md 파일로 설명됩니다. AI 에이전트는 작업에 필요할 때만 이를 찾아 불러옵니다.
에이전트 훅
에이전트 훅(agent hooks)은 코딩 에이전트가 도구 호출 전이나 파일 수정 후처럼 작업 중 정해진 시점에 자동으로 실행하는, 사용자가 정의한 명령이나 스크립트입니다. 에이전트의 동작을 점검하거나, 막거나, 확장하는 데 씁니다.
시스템 프롬프트(System prompt)
시스템 프롬프트(system prompt)는 애플리케이션이 사용자 메시지보다 먼저 언어 모델에 보내는 지시 블록입니다. 대화 전체에 걸쳐 모델의 역할, 규칙, 어조, 출력 형식을 정합니다.
슬래시 명령(Slash command)
슬래시 명령(slash command)은 /compact나 /review처럼 앞에 슬래시를 붙여 입력하는 지시로, AI 도구가 텍스트를 일반 메시지로 다루지 않고 내장 동작이나 저장된 프롬프트를 실행하게 합니다.

출처