9장. AGENTS.md로 작업 기준 남기기
대화에 적을 지시와 AGENTS.md에 남길 기준
분기 운영 리포트를 만들 때마다 “원본은 바꾸지 말 것”, “담당자와 날짜를 추측하지 말 것”, “새 문서는 결과 폴더에 만들 것” 같은 기준을 확인한다고 해보겠습니다. 이번 요청에서만 필요한 지시라면 대화에 적으면 됩니다. 프로젝트를 열 때마다 지켜야 하는 기준이라면 AGENTS.md에 남겨 두세요.
AGENTS.md는 작업 방법을 적어 두는 지침 파일입니다. 다만 권한을 강제로 막는 보안 설정은 아닙니다. “원본을 수정하지 않는다”처럼 지켜야 할 행동 기준은 이 파일에 쓰고, 실제 파일과 네트워크에 접근할 수 있는 범위는 10장의 권한 설정에서 따로 확인합니다.
어느 폴더의 지침을 먼저 읽는지, 기준이 충돌할 때 무엇을 우선하는지는 공식 AGENTS.md 문서에서 확인하세요.
세션 시작 위치에 따라 처음 읽을 지침이 달라집니다
ChatGPT는 로컬 작업을 시작하면 그 작업에 적용할 지침을 한데 모읍니다. 먼저 사용자 공통 지침을 읽고, 프로젝트 루트에서 현재 작업 폴더까지 내려가며 폴더별 지침을 이어 붙입니다. 현재 폴더에 가까운 지침일수록 나중에 읽히므로 더 구체적인 기준으로 작동합니다.
| 범위 | 기본 위치 | 넣을 내용 |
|---|---|---|
| 개인 | $CODEX_HOME/AGENTS.md, 기본적으로 ~/.codex/AGENTS.md | 언어, 설명 방식처럼 모든 프로젝트에 적용할 선호 |
| 프로젝트 | 프로젝트 루트의 AGENTS.md | 원본 보존, 결과 위치, 검증 방식 |
| 하위 폴더 | 현재 폴더까지의 각 AGENTS.md | 그 폴더에서만 필요한 형식과 금지 사항 |
같은 폴더에 AGENTS.override.md가 있으면 그 파일을 먼저 고릅니다. 그래서 같은 폴더의 AGENTS.md는 함께 읽지 않습니다. 개인 범위에서도 AGENTS.override.md가 있으면 같은 규칙이 적용됩니다. 임시로 기준을 덮어쓸 필요가 없다면 보통 AGENTS.md 하나면 충분합니다.
프로젝트 루트를 찾지 못하면 현재 폴더만 검사합니다. 반대로 루트에서 시작한 세션이 나중에 발견한 하위 AGENTS.md까지 자동으로 다시 읽는다고 기대해서는 안 됩니다. 하위 폴더의 규칙을 확인하려면 그 폴더에서 새 작업을 시작하세요.
가상 분기리포트로 루트와 하위 폴더의 우선순위를 확인합니다
적용 범위를 비교하려면 이름과 내용을 정해 둔 가상 연습 폴더를 하나 만듭니다. 폴더 구조는 다음처럼 잡습니다.
분기리포트/
├── AGENTS.md
├── 원본/
│ └── 회의메모.md
├── 결과/
└── 검토/
└── AGENTS.md
원본/회의메모.md에는 확인할 사실을 적습니다.
# 3분기 운영 회의
- 리포트 초안 마감: 2026-07-18
- 작성 담당: 운영팀
- 외부 공유일: 아직 정하지 않음
- 매출 원인: 회의에서 확인하지 않음
프로젝트 루트의 AGENTS.md에는 다음과 같은 작업 기준을 씁니다.
