{"id":"codex-agents-md","kind":"workflow","testedWith":[],"durationMin":null,"url":"https://opencurrent.ai/w/codex-agents-md","title":"저장소 규칙을 에이전트에게 매번 자동 전달 (Codex AGENTS.md)","summary":"테스트 명령이나 패키지 관리자 같은 저장소 규칙을 작업마다 다시 말하지 않아도, Codex가 작업 전에 먼저 읽고 시작합니다.","category":"개발","categoryId":"dev","domain":"dev","domainLabel":"개발","capabilities":[{"id":"code","label":"코드 작성"}],"topics":[{"id":"dev","label":"개발"}],"tools":["Codex CLI"],"whenToUse":"모든 저장소에 쓸 공통 규칙은 ~/.codex/AGENTS.md에, 저장소 규칙은 루트의 AGENTS.md에 적습니다. 폴더마다 다른 규칙은 그 폴더에 따로 두고, 마지막으로 Codex가 어떤 규칙을 읽었는지 확인합니다.","body":"## 준비\n\n- Codex CLI 설치\n- Git 저장소 하나\n\n### 1. 전역 규칙 파일 만들기\n\n`~/.codex` 폴더를 만들고 `AGENTS.md`에 모든 저장소에 공통인 선호를 적습니다. 예를 들면 JavaScript를 고친 뒤 npm test 실행, pnpm 우선, 운영 의존성 추가 전 확인 같은 규칙입니다. 빈 파일은 건너뛰므로 몇 줄이라도 적습니다.\n\n```bash\nmkdir -p ~/.codex\n$EDITOR ~/.codex/AGENTS.md\n```\n\n### 2. 전역 규칙 적용 확인\n\n승인 없이 한 번 실행해 지금 읽힌 지시를 요약하게 합니다.\n\n```bash\ncodex --ask-for-approval never \"Summarize the current instructions.\"\n```\n\n방금 적은 규칙이 답에 나오면 됩니다.\n\n### 3. 저장소 루트에 AGENTS.md 추가\n\nGit 저장소 루트의 `AGENTS.md`에 이 저장소만의 규칙을 적습니다. 예를 들면 PR 전 npm run lint 실행, 공개 유틸리티는 docs/에 문서화 같은 규칙입니다.\n\n### 4. 하위 폴더에 덮어쓰기 규칙 추가\n\n명령이 다른 하위 폴더에는 `AGENTS.override.md`를 만듭니다. 예를 들어 npm test 대신 make test-payments를 쓰게 합니다. 깊은 폴더의 지시가 위쪽 지시보다 우선합니다.\n\n```bash\n$EDITOR <하위 폴더>/AGENTS.override.md\n```\n\n### 5. 읽힌 규칙 순서 확인\n\n하위 폴더 기준으로 실행해 읽은 지시의 출처를 나열하게 합니다.\n\n```bash\ncodex --cd <하위 폴더> --ask-for-approval never \"List the instruction sources you loaded.\"\n```\n\n전역 파일, 루트 `AGENTS.md`, 하위 폴더의 override 순서로 세 파일이 나오면 됩니다.\n\n### 6. 다른 파일 이름 쓰기 (선택)\n\n이미 다른 이름의 안내 파일이 있으면 `config.toml`에 대체 이름을 등록하고 크기 한도도 함께 조정합니다. 저장한 뒤 Codex를 다시 시작합니다.\n\n```bash\n# ~/.codex/config.toml\nproject_doc_fallback_filenames = [\"TEAM_GUIDE.md\", \".agents.md\"]\nproject_doc_max_bytes = 65536\n```\n\n이제 폴더마다 AGENTS.override.md → AGENTS.md → TEAM_GUIDE.md → .agents.md 순서로 찾습니다. 다시 시작한 뒤 출처 목록에 TEAM_GUIDE.md가 보이면 됩니다.\n\n## 주의\n\n- 합친 크기가 `project_doc_max_bytes`(기본 32 KiB)에 닿으면 그 뒤 파일은 읽지 않습니다. 한도를 올리거나 하위 폴더로 나눕니다.\n- 현재 폴더보다 아래는 찾지 않습니다. 덮어쓰기 파일은 해당 작업 폴더 가까이에 둡니다.\n- 규칙이 엉뚱하게 적용되면 위쪽 폴더나 Codex 홈의 `AGENTS.override.md`를 확인합니다.\n- 지시 목록은 실행(세션)마다 한 번 만들어집니다. 바뀐 내용이 안 보이면 대상 폴더에서 Codex를 다시 시작합니다.\n- 프로필이 헷갈리면 실행 전에 `echo $CODEX_HOME`으로 확인합니다.","prerequisites":["Codex CLI 설치","Git 저장소 하나"],"inputs":[{"name":"subdir","label":"하위 폴더","description":"따로 규칙을 줄 하위 폴더 경로","example":"services/payments","required":false}],"howToFollow":"1. 준비물이 갖춰졌는지 먼저 확인할 것.\n2. body를 처음부터 끝까지 읽고 순서대로 따라 할 것. 코드 블록의 명령은 사용자의 허락을 받고 실행하고, 사람이 해야 하는 일은 사용자에게 안내하고 끝났는지 물을 것.\n3. 본문에 확인 방법이 있으면 그대로 확인하고, 다르면 다음으로 넘어가지 말고 사용자에게 알릴 것.\n4. 검증 상태가 verified가 아니면 그 사실을 사용자에게 먼저 알릴 것. 답에 url을 출처로 밝힐 것.","steps":[{"n":1,"kind":"command","title":"전역 규칙 파일 만들기","body":"~/.codex 폴더 생성 후 AGENTS.md에 모든 저장소 공통 선호 작성. 예: JavaScript 변경 뒤 npm test 실행, pnpm 우선, 운영 의존성 추가 전 확인.","prompt":"mkdir -p ~/.codex\n$EDITOR ~/.codex/AGENTS.md","expected":"~/.codex/AGENTS.md에 공통 규칙 몇 줄","check":"파일이 비어 있지 않으면 성공 (빈 파일은 건너뜀)","tool":"Codex CLI"},{"n":2,"kind":"command","title":"전역 규칙 적용 확인","body":"승인 없이 한 번 실행해 지금 읽힌 지시를 요약하게 함.","prompt":"codex --ask-for-approval never \"Summarize the current instructions.\"","expected":"전역 파일의 항목이 담긴 요약","check":"방금 적은 규칙이 답에 나오면 성공","tool":"Codex CLI"},{"n":3,"kind":"human","title":"저장소 루트에 AGENTS.md 추가","body":"저장소 루트에 이 저장소만의 규칙 작성. 예: PR 전 npm run lint, 공개 유틸리티는 docs/에 문서화.","expected":"저장소 루트의 AGENTS.md","check":"git 루트에 파일이 있고 내용이 있으면 성공","tool":"Codex CLI"},{"n":4,"kind":"command","title":"하위 폴더에 덮어쓰기 규칙 추가","body":"명령이 다른 하위 폴더에 AGENTS.override.md 작성. 예: npm test 대신 make test-payments. 깊은 폴더의 지시가 위쪽 지시보다 우선.","prompt":"$EDITOR {{subdir}}/AGENTS.override.md","expected":"{{subdir}}/AGENTS.override.md","check":"해당 폴더에 파일이 있으면 성공","tool":"Codex CLI"},{"n":5,"kind":"command","title":"읽힌 규칙 순서 확인","body":"하위 폴더 기준으로 실행해 읽은 지시 출처를 나열하게 함.","prompt":"codex --cd {{subdir}} --ask-for-approval never \"List the instruction sources you loaded.\"","expected":"전역 파일 → 루트 AGENTS.md → 하위 폴더 override 순서의 목록","check":"세 파일이 이 순서로 나오면 성공","tool":"Codex CLI"},{"n":6,"kind":"command","title":"다른 파일 이름 쓰기 (선택)","body":"이미 다른 이름의 안내 파일이 있으면 config.toml에 대체 이름 등록, 크기 한도도 함께 조정. 저장 뒤 Codex 다시 시작.","prompt":"# ~/.codex/config.toml\nproject_doc_fallback_filenames = [\"TEAM_GUIDE.md\", \".agents.md\"]\nproject_doc_max_bytes = 65536","expected":"폴더마다 AGENTS.override.md → AGENTS.md → TEAM_GUIDE.md → .agents.md 순서로 탐색","check":"다시 시작 후 출처 목록에 TEAM_GUIDE.md가 보이면 성공","tool":"Codex CLI"}],"pitfalls":["합친 크기가 project_doc_max_bytes(기본 32 KiB)에 닿으면 이후 파일은 읽지 않음. 한도를 올리거나 하위 폴더로 나누기","현재 폴더보다 아래는 탐색하지 않음. 덮어쓰기 파일은 해당 작업 폴더 가까이에 두기","규칙이 엉뚱하면 위쪽 폴더나 Codex 홈의 AGENTS.override.md 확인","지시 목록은 실행(세션)마다 한 번 만들어짐. 바뀐 내용이 안 보이면 대상 폴더에서 Codex 다시 시작","프로필이 헷갈리면 실행 전 echo $CODEX_HOME 확인"],"sources":[{"title":"Custom instructions with AGENTS.md","url":"https://learn.chatgpt.com/docs/agent-configuration/agents-md"}],"verification":{"status":"pending","label":"검수 대기","detail":"사람 확인 전","verifiedBy":0,"lastVerifiedAt":null},"quality":{"score":32,"components":{"result":0.5,"trust":0,"freshness":0.4},"explanation":"확인 없음 · 검수 대기"},"workedFor":0,"trials":{"summary":"","lastAt":null,"total":0,"worked":0,"partial":0,"failed":0,"recent":[]},"asOf":{"date":"2026-11-15T07:14:52.106705+00:00","basis":"updated"},"updatedAt":"2026-11-15T07:14:52.106705+00:00","goals":[{"id":"dev","title":"개발"}],"uses":29,"likes":0}