Codex Bootstrap

Codex Bootstrap

이 저장소의 정식 지침 원본은 CLAUDE.md와 .claude/ 아래 문서다.

Codex는 작업을 시작하기 전에 아래 순서로 처리한다.

  1. 먼저 루트 CLAUDE.md를 읽는다.
  2. 이어서 CLAUDE.md가 가리키는 .claude/skills/*, .claude/agents/*, .claude/memory/*를 필요 범위만 읽는다.
  3. 규칙 충돌이 있으면 AGENTS.md보다 CLAUDE.md와 .claude/ 문서를 우선한다.
  4. delegation이 필요하면 Codex 전용 에이전트 설정을 새로 만들지 말고, .claude/agents/* 문서를 역할 원본으로 사용한다.

핵심 안전 규칙:

  • AdSense/광고/수익화 관련 변경은 항상 최우선으로 보호하고, 영향 가능성이 있으면 두세 번 검증한다.
  • git reset --hard, force push 같은 파괴적 git 작업은 반드시 사용자 확인 후 진행한다.

추가 규칙:

  • .claude/를 단일 소스로 유지한다. 같은 내용을 AGENTS.md에 다시 복제하지 않는다.
  • 서브에이전트 역할 정의도 .claude/agents/*를 단일 소스로 유지한다. Codex용 별도 에이전트 문서는 만들지 않는다.
  • Claude Code의 “서브에이전트”와 Codex의 “delegation”은 역할 분담 개념은 비슷하지만, 내부 실행 엔진은 다를 수 있다.
  • Codex는 .claude/agents/* 문서를 역할 프롬프트의 원본으로 참고해 delegation한다. 즉 기준 문서는 같지만 결과와 동작감은 완전히 동일하지 않을 수 있다.
  • .agents/skills/*는 Codex 스킬 발견용 호환 wrapper다. 실질 규칙은 .claude/skills/*에 둔다.
  • .agents/ 아래에는 Codex가 발견해야 하는 스킬 wrapper만 둔다. 에이전트 역할 정의는 두지 않는다.