에이전트용 지침 파일을 어디에 둘지 정하는 문제

Claude MDAgents MD 파일은 인공지능 에이전트가 프로젝트의 중요한 문맥을 다시 찾도록 돕는 지침 파일로 쓰인다. 설정 방식은 크게 세 가지로 나뉜다.

첫째, 프로젝트 최상위 폴더에 Claude MD 하나만 두고 전체 지침을 짧게 적는 방식이다. 둘째, 폴더마다 Claude MD를 두어 해당 영역의 세부 차이를 적고, 최상위 파일에서 이를 참고하게 하는 방식이다.

셋째, 별도 문서 폴더에 중요한 결정과 작업 문맥을 모아 두고, 매 작업 뒤에 내용을 추가하는 방식이다. 어떤 방식이 좋은지는 저장소 크기와 코드 구조의 복잡도에 따라 달라질 수 있다.

핵심 포인트

  • Claude MDAgents MD는 에이전트가 프로젝트 문맥을 회복하는 데 쓰이는 지침 파일이다.
  • 최상위 파일 하나만 두면 단순하지만 세부 폴더 규칙을 담기 어렵다.
  • 폴더별 지침을 두면 영역별 차이를 알려줄 수 있지만 관리할 파일이 늘어난다.
  • 별도 문서 폴더에 결정과 문맥을 쌓는 방식은 장기 작업에 도움이 될 수 있다.
  • 저장소가 클수록 지침을 나누되, 토큰 사용량이 커지지 않게 짧게 관리해야 한다.

용어 한 줄 설명

Claude MD
Claude 같은 AI 도구에 프로젝트 규칙이나 작업 지침을 적어 두는 파일을 가리키는 말입니다.
Agents MD
AI 에이전트가 따라야 할 규칙이나 작업 방식을 적어 두는 지침 파일을 가리키는 말입니다.
agents
사용자 지시를 받아 코드를 고치거나 작업을 진행하는 AI 도구입니다.
MD 파일
마크다운 형식으로 쓴 문서 파일입니다.
인공지능 에이전트
사용자 지시에 따라 정보를 찾거나 저장하는 일을 대신 처리하는 인공지능 도구다.
인공지능
인간처럼 생각하고 문제를 해결하도록 만든 컴퓨터 프로그램입니다.
저장소
코드와 관련 파일을 모아 둔 프로젝트 폴더입니다.
토큰 사용량
AI에게 보내고 받은 글의 양을 세는 단위 사용량입니다.
원문 보기