agent.md

핵심 아이디어

agent.md는 AI가 프로젝트의 목적, 구조, 규칙을 이해하도록 돕는 지시 문서입니다. 코드처럼 실행되는 파일이 아니라, AI가 코드를 만들 때 참고하는 안내서입니다.

쉽게 말하면

agent.md는 “AI에게 주는 프로젝트 업무 매뉴얼”입니다. 새로 온 동료에게 프로젝트 설명서를 주듯, AI에게도 기준 문서를 주는 것입니다.

예시

agent.md에는 이런 내용을 적을 수 있습니다.

• 프로젝트 목적
• 현재 만들 기능 범위
• 모듈과 컴포넌트 역할
• 데이터 모양
• 코딩 규칙
• AI에게 요청할 때 지켜야 할 기준

헷갈리기 쉬운 점

agent.md는 프로그램의 일부가 아닙니다. 사용자가 실행하는 파일도 아닙니다. 프로젝트가 바뀌면 함께 고쳐야 하는 살아있는 문서입니다.

실제 IT 용어와의 연결

• 실제 현업에서는 project instructions, repository guidelines, AI coding agent instructions 같은 말과 연결됩니다.
• 팀 프로젝트의 README.md, CONTRIBUTING.md, 개발 규칙 문서와 비슷한 역할을 합니다.
• AI 도구를 쓸 때는 “매번 다시 설명하지 않아도 되는 프로젝트 기준 문서”로 이해하면 좋습니다.

이 블로그에서의 역할

3편에서는 작업 계획 문서와 구조 설계를 바탕으로 agent.md를 작성해, 이후 AI에게 코드를 요청할 때 기준으로 사용합니다.