CHAPTER 02 · 12 / 24
폴더 설명서 ‘AGENTS.md’ 만들기
『ChatGPT Work로 일하기』 제2장 ChatGPT Work를 사용해 보자 · 김재우 · 2026년 11월 23일
폴더 설명서 AGENTS.md를 만드는 방법입니다. AGENTS.md에 적을 내용(자기·회사 소개, 폴더에서 할 작업, 자료 설명, 말투와 규칙), 파일 이름 주의점, 파일을 두는 위치를 설명합니다.
CHAPTER 02 · 12 / 24
『ChatGPT Work로 일하기』 제2장 ChatGPT Work를 사용해 보자 · 김재우 · 2026년 11월 23일
폴더 설명서 AGENTS.md를 만드는 방법입니다. AGENTS.md에 적을 내용(자기·회사 소개, 폴더에서 할 작업, 자료 설명, 말투와 규칙), 파일 이름 주의점, 파일을 두는 위치를 설명합니다.
작업 폴더를 만들었다면 그 폴더에 ChatGPT Work용 설명서를 준비하겠습니다. 이 역할을 하는 것이 AGENTS.md라는 마크다운 파일입니다.
AGENTS.md는 ChatGPT Work와 Codex를 비롯한 여러 AI 에이전트 도구가 공통으로 사용하는 ‘폴더 설명서’ 형식입니다. 이 이름의 마크다운 파일을 작업 폴더 바로 아래에 두면, ChatGPT Work가 작업을 시작할 때 먼저 읽고 그 규칙을 반영해 작업합니다.
메모 — 파일 이름 주의
파일 이름은 정확히
AGENTS.md로 작성하세요.agents.md나AGENT.md는 올바르게 인식되지 않을 수 있으므로 대소문자와 철자에 주의해야 합니다.
AGENTS.md에 적을 내용은 다음과 같습니다.
처음부터 완벽하게 작성할 필요는 없습니다. 간단하게 시작한 다음 사용하면서 필요한 규칙을 조금씩 추가하는 편이 좋습니다.
AGENTS.md도 앞 절과 마찬가지로 채팅 지시만으로 만들 수 있습니다. 다음과 같이 요청해 보세요.
프롬프트
이 폴더 바로 아래에 ‘AGENTS.md’ 파일을 만들어 주세요. 내용은 다음과 같습니다.
# AGENTS.md
- 저를 김민수라고 불러 주세요.
- 저는 대한민국 서울시에 살고 있습니다.
- 저는 생성형 AI 교육과 도입 지원 업무를 하고 있습니다.
- 글 작성을 요청하면 반드시 ‘~합니다’체로 작성해 주세요.
- 제 컴퓨터 사용 환경은 Windows 11입니다.
처음에는 이처럼 최소한의 행동 규칙만 적습니다. 그다음 실제로 사용하면서 보완하면 됩니다. 예를 들어 ‘좀 더 엄격하게 조언해 주면 좋겠다’, ‘기술 용어가 많아 이해하기 어렵다’고 느끼면 다음 줄을 추가합니다.
추가할 규칙 예시
- 조언할 때는 무조건 동의하지 말고 정확하게 지적해 주세요.
- 기술 용어나 전문 용어는 이해하기 쉽게 설명해 주세요.
참고해야 할 다른 파일을 준비했다면 다음과 같은 안내를 적어 둡니다.
참조 파일 안내 예시
- 회사 정보를 참고할 때는 ‘company-profile.md’를 읽습니다.
- 글을 검토할 때는 ‘brand-voice-check.md’를 읽습니다.
- 고객 목록을 다룰 때는 ‘customer-list.csv’를 읽습니다.
이렇게 필요하다고 느낀 사항을 그때그때 추가하면 됩니다. 수정할 때도 채팅에서 ‘AGENTS.md에 다음 규칙을 추가해 주세요’라고 요청하면 됩니다.
나머지 내용은 읽기 화면에서 이어서 볼 수 있어요.
이어서 읽기