에이전트 명세 파일 (agent.md)은 에이전트 (Agent)에게 건네는 '직원 입사 안내서' 같은 것 — 이름·역할·쓸 수 있는 도구·말투까지 한 파일에 적어두면 에이전트가 그 설명서대로 행동한다.
새 직원이 첫날 받는 업무 매뉴얼을 떠올려 보자. '당신의 이름은 OO이고, 고객 문의를 담당하며, 이런 말투로 답하고, 이 도구만 쓸 수 있습니다'라고 적힌 문서다. 에이전트 명세 파일 (agent.md)은 바로 그 역할을 한다. 코덱스(Codex)는 AGENTS.md, 클로드 코드(Claude Code)는 CLAUDE.md 라는 이름의 파일을 프로젝트 폴더에서 읽어, 에이전트가 따라야 할 규칙·역할·작업 방식을 사람이 읽을 수 있는 텍스트로 정의해 둔다.
1인 비즈니스 운영자라면 처음 에이전트를 설정할 때 이 파일을 만지게 된다. 예를 들어 블로그 독자 문의를 받는 에이전트를 만들 때는 '친근한 말투로 답하고, 브라우저 (browser) 도구로 최신 글을 검색해서 링크를 첨부하라'고 agent.md 에 적어두면 된다. 뉴스레터 구독자 응대 에이전트, 쇼핑몰 주문 안내 에이전트, SaaS 고객 온보딩 (Onboarding) 에이전트 등 역할이 달라질 때마다 이 파일 하나만 바꾸면 에이전트의 행동 전체가 바뀐다. 보통 프로젝트 폴더 맨 위(루트)에 두면 에이전트가 자동으로 찾아 읽는다.
초보자가 흔히 혼동하는 점은 agent.md 를 '프롬프트'와 같다고 보는 것이다. 프롬프트는 대화창에 한 번 입력하면 끝이지만, agent.md 는 에이전트가 켜질 때마다 읽는 '고정 설명서'다. 한 번 잘 써두면 매번 같은 말을 반복할 필요가 없고, 스킬 (Skill)을 추가할 때도 이 파일에 언제 그 스킬을 쓰라고 적어 두면 역할을 확장할 수 있다.
AI 에이전트를 직접 만들고 24시간 운영하는 법을 단계별 강의로 배워보세요.
