ilhae.ai

CHAPTER 02 · 12 / 24

폴더 설명서 ‘AGENTS.md’ 만들기

『ChatGPT Work로 일하기』 제2장 ChatGPT Work를 사용해 보자 · 김재우 · 2026년 11월 23일

폴더 설명서 AGENTS.md를 만드는 방법입니다. AGENTS.md에 적을 내용(자기·회사 소개, 폴더에서 할 작업, 자료 설명, 말투와 규칙), 파일 이름 주의점, 파일을 두는 위치를 설명합니다.

여기서 다루는 것

  1. 보충: ‘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에 다음 규칙을 추가해 주세요’라고 요청하면 됩니다.

나머지 내용은 읽기 화면에서 이어서 볼 수 있어요.

이어서 읽기

ilhae.ai 안내 도우미대기 중

글자를 치면 사이트 자료를 바로 찾아요. AI 대화는 하루 20번까지이고, 질문 앞부분은 서비스 개선을 위해 30일 보관해요. 개인정보는 적지 마세요.