라이프스타일
AGENTS.md 범위와 우선 규칙
루트와 하위 폴더의 지침, 충돌, override를 추적해 선택된 문서를 확인합니다.
읽는 데 약 12분 · 실습 25 분

이 글의 목차
Codex 학습 목차로 돌아가기Codex 학습 센터: 전체 튜토리얼 목차설치와 첫 작업부터 MD 지침과 고급 연동까지 60개 강의, 열 개 단원을 계획합니다. 수준, 환경, 목표, 명령으로 다음 글을 찾고 미게시 항목의 상태를 확인할 수 있습니다.전체 글 읽기
목표와 준비
AGENTS.mdAGENTS.md 프로젝트 규칙AGENTS.md는 작업 시작 전 프로젝트 지침을 제공하는 파일입니다. 전역 지침과 프로젝트 루트부터 현재 작업 폴더까지의 규칙이 연결됩니다. 같은 위치에서는 AGENTS.override.md가 우선합니다. 실제로 무엇을 읽었는지 검증해야 합니다.전체 글 읽기는 작업 지침, config.tomlconfig.toml 설정config.toml은 설정 값을, AGENTS.md는 작업 지침을 다룹니다. 사용자 설정 외에 신뢰하는 프로젝트에 .codex/config.toml을 둘 수 있습니다. 인자와 조직 정책도 있으므로 파일 하나만으로 적용 값을 판단하지 않습니다.전체 글 읽기은 다른 우선순위의 앱 설정입니다. 권한을 넓히지 않고 응답 표식과 공통 요구를 관찰합니다. 파일을 인용할 수 있다는 것만으로 시작 시 발견된 증거는 아니므로 동작과 작업 경로도 확인합니다.
로드 순서 이해
전역은 기본 사용자 .codex 또는 기존 CODEX_HOME 위치입니다. 프로젝트는 인식된 루트에서 현재 경로까지 탐색하며 모든 형제 폴더를 훑지 않습니다. 각 층에서 AGENTS.override.md, AGENTS.md, 설정된 대체명 순으로 최대 하나를 선택합니다. 깊은 층은 충돌 항목을 덮어쓰고 양립하는 요구는 유지합니다.
| 상황 | 선택하는 규칙 | 가정하면 안 되는 것 |
|---|---|---|
| 루트 시작 | 루트 규칙 | 모든 하위 폴더 로드 |
| ui 시작 | 루트 다음 ui | 강제 정책 취소 가능 |
| ui에 비어 있지 않은 override | 루트 다음 ui override | 같은 층 AGENTS.md도 합침 |
| 이전 세션에서 편집 | 이전 문맥이 남을 수 있음 | 저장하면 새로 로드됨 |
1단계: 독립 규칙 실습 만들기
새 codex-rules-lab에 ui와 data를 만들고 override는 아직 두지 않습니다. 편집기로 열고 PowerShell의 Get-Location 또는 macOS/Linux의 pwd로 새 실습 경로를 확인합니다. 다음 Git 초기화로 루트를 명확히 하며 커밋이나 원격 연결은 필요 없습니다.
git init
git rev-parse --show-toplevel
루트 AGENTS.md에 다음 전체 내용을 저장합니다. ROOT-LAB은 관찰할 응답 접두사, KEEP-DATA는 하위에도 유지할 공통 요구입니다. 실험용 표식이므로 실제 규칙은 테스트, 자료 보존, 인계 요구로 바꿉니다.
# Root practice instructions
- Start the final answer with ROOT-LAB.
- Include KEEP-DATA in the final answer.
- Do not change any files for the rule-discovery exercise.
- Report checks that were actually performed separately from unverified claims.
둘째 내용은 ui/AGENTS.md, 자료 메모는 data/README.md에 저장합니다. README는 의도적으로 AGENTS가 아니며 해당 대체명 설정이 없으면 Markdown이라는 이유만으로 시작 지침이 되지 않습니다. 대소문자와 잘못 붙은 .txt를 확인합니다.
# UI practice instructions
- Start the final answer with UI-LAB instead of ROOT-LAB.
- Include UI-BASE in the final answer.
# Data notes
This folder describes fictional practice data.
DATA-NOTE is a document marker, not a required answer prefix.
2단계: 두 경로에서 각각 시작
실습 루트에서 첫 읽기 전용 실행 명령을 쓰고 Codex에 다음 요청을 보냅니다. 규칙 전문이나 예상 접두사는 붙이지 않습니다. ROOT-LAB과 KEEP-DATA가 예상됩니다. /exit로 셸에 돌아와 resume 대신 둘째 명령으로 ui 새 세션을 시작합니다.
codex --cd . --sandbox read-only
Without changing files, report the current working directory and the project instruction sources already available to this session. Follow the active response-format instructions. Do not search unrelated sibling folders just to collect more rules. Distinguish known loaded instructions from files you have not inspected.
codex --cd ui --sandbox read-only
ui에서도 같은 요청을 보내 UI-LAB, KEEP-DATA, UI-BASE를 확인합니다. 접두사는 하위가 덮어쓰고 양립하는 루트 요구는 남습니다. 수동 읽기를 요청한 뒤에야 설명하면 시작 시 발견과 구분해 기록합니다. 모델 자기 보고는 로드 로그가 아니며 부족한 증거를 성공 처리하지 않습니다.
3단계: 같은 층 override 추가 및 비교
ui를 종료하고 AGENTS.md를 남긴 채 같은 층에 다음 AGENTS.override.md를 추가합니다. 실습 루트에서 같은 ui 실행 명령/요청을 사용합니다. UI-OVERRIDE와 KEEP-DATA가 예상되며 대체된 같은 층 파일의 UI-BASE는 들어오지 않아야 합니다. override는 해당 층 후보를 바꾸며 루트/전역 전체를 지우지 않습니다.
# UI override practice
- Start the final answer with UI-OVERRIDE instead of ROOT-LAB.
- Include OVERRIDE-ACTIVE in the final answer.
경계 확인은 override를 백업 후 비우고 새 시작의 실제 결과를 기록합니다. 이 컴퓨터의 codex-cli 0.154.0-alpha.6.2 진단 입력에는 빈 본문도 같은 층 AGENTS.md도 없고 루트 규칙만 남았습니다. 빈 파일을 확실한 비활성화로 믿지 말고 대체명 목록에 없는 override.saved.md로 바꾼 뒤 새로 시작해 UI-LAB, UI-BASE, KEEP-DATA를 확인합니다. 전역 파일/전체 설정은 삭제하지 않습니다.
하나의 기록에서 로드와 준수 구분하기
루트, UI, override, 빈 override, 이름을 바꾼 복구 상태마다 새로 시작해 기록하세요. 실제 답변 칸에 기대값을 미리 적지 마세요. 진단 입력에 UI override가 있지만 답변에 OVERRIDE-ACTIVE가 없다면 입력 포함은 확인했으나 형식 준수는 실패한 것입니다. 파일 미로드로 단정할 수 없으며 모델의 자기 설명도 진단 입력의 증거가 아닙니다. 개인 입력에는 다른 규칙이 포함될 수 있으므로 실습에 필요한 요약만 남깁니다.
Case: [root / UI / override / empty override / renamed restoration]
CLI version and start directory: [actual values]
New session: [yes / no / unverified]
Instruction-file state: [paths, nonempty/empty/renamed]
Expected markers: [prediction]
Instruction-source evidence: [observed input/log / model statement only / unavailable]
Actual answer markers: [observed values / no model run]
Conclusion: [discovery verified? response verified? remaining uncertainty]
실패 진단과 완료 기준
표식 누락은 확장자/내용/Git 루트/--cd, 오래된 표식은 resume가 아닌 새 시작 여부, 일부 누락은 같은 층 override/전역/상위 지침을 확인합니다. 깊은 AGENTS.md가 조직 정책, 도구 권한, 사용자 요청을 넘는 허가는 아닙니다. 충돌 출처를 찾고 자신이 관리할 수 있는 규칙을 수정합니다.
긴 지침은 기본 합계 32 KiB 제한에 걸릴 수 있으며 문자 수가 아닌 바이트입니다. 핵심 규칙을 남기고 긴 설계/예시는 필요할 때 읽는 일반 문서로 옮깁니다. 형제 폴더로 나눠도 모두 자동 로드되지는 않습니다. 대체명/한도는 설정config.toml 설정config.toml은 설정 값을, AGENTS.md는 작업 지침을 다룹니다. 사용자 설정 외에 신뢰하는 프로젝트에 .codex/config.toml을 둘 수 있습니다. 인자와 조직 정책도 있으므로 파일 하나만으로 적용 값을 판단하지 않습니다.전체 글 읽기에서 다루며 변경 후 재시작 검증합니다.
루트/ui/override/빈 override/개명 복원의 시작 경로, 파일 상태, 실제 표식을 남깁니다. KEEP-DATA를 유지하고 override 제거 후 ui로 돌아가는지 확인합니다. 로컬은 debug prompt-input의 실제 입력을 확인했으며 모델 요청/준수 주장은 없습니다. 사양과 버전 차이를 기록하고 응답 동작은 새 세션에서 별도로 확인합니다. 규칙과 문서 분담규칙, 설명, 문맥 파일 구분작업 규칙, 프로젝트 진입점, 설계 조건, 인계 상태를 나누고 오래된 가설을 실제 파일과 테스트로 확인합니다.전체 글 읽기으로 이어 갑니다.
Codex 학습 목차로 돌아가기Codex 학습 센터: 전체 튜토리얼 목차설치와 첫 작업부터 MD 지침과 고급 연동까지 60개 강의, 열 개 단원을 계획합니다. 수준, 환경, 목표, 명령으로 다음 글을 찾고 미게시 항목의 상태를 확인할 수 있습니다.전체 글 읽기
자세한 설명 보기
Three numbered stages: identify the starting point, perform the exercise, and verify the result. Original illustration, not a product screenshot.
이 정리가 도움이 되셨나요? 필요한 분께 공유해 보세요
같은 주제의 글
라이프스타일
Codex 학습 센터: 전체 튜토리얼 목차
설치와 첫 작업부터 MD 지침과 고급 연동까지 60개 강의, 열 개 단원을 계획합니다. 수준, 환경, 목표, 명령으로 다음 글을 찾고 미게시 항목의 상태를 확인할 수 있습니다.
라이프스타일
Worktree와 작업 격리
Worktree는 하나의 Git 저장소에 다른 브랜치의 작업 폴더를 만듭니다. 파일이 분리되어도 DB, 포트와 외부 서비스는 공유될 수 있습니다.
라이프스타일
실습: 작은 웹사이트 만들기
brief.md에서 Small Steps 할 일 사이트를 계획하고 추가·완료·삭제·필터·로컬 저장을 구현합니다. HTML·CSS·데이터 함수·화면 이벤트·시험을 분리하고 Node와 브라우저로 검증한 뒤 재시작·복원 인계 기록을 남깁니다.
이 글을 인용한 글
출처
위에 기재된 참고 자료와 확인일 기준 정보를 바탕으로 정리했습니다. 요금, 시간표, 기능, 이용 약관은 바뀔 수 있으므로 여행, 예약 또는 구매 전에 해당 공식 사이트에서 최신 정보를 확인해 주세요.