CLAUDE.md@codex · diff
git:20260508.4249183 to git:20260726.3cf3297
4 added, 2 removed. Audit A to A.
# Codex Edition (Cross-Edition Lookup)
You are working in the Codex edition tree. The default Codex instructions in this directory live in [`AGENTS.md`](AGENTS.md), which Claude Code does not auto-load. Read it before editing.
## Read Before Editing
- [`AGENTS.md`](AGENTS.md) — Codex edition rules and overlay
- - [`SKILL-CONVENTIONS.md`](SKILL-CONVENTIONS.md) — Codex skill conventions, plus a "Harness Reference" section with tool names, sandbox/approval modes, sub-agent limits, and skill/AGENTS.md hierarchies, and a "Harness Vocabulary" table that translates Claude Code terms into Codex equivalents
+ - [`SKILL-CONVENTIONS.md`](SKILL-CONVENTIONS.md) — Codex skill conventions
+ - [`skills/create-skill/references/harness.md`](skills/create-skill/references/harness.md) — harness facts: tool names, sandbox and approval modes, sub-agent limits, skill and AGENTS.md hierarchies
+ - [`docs/harness-vocabulary.md`](docs/harness-vocabulary.md) — table translating Claude Code terms into Codex equivalents
- [`ADDITIONS.md`](ADDITIONS.md) — Codex-specific user instructions
## Vocabulary
- Use Codex vocabulary in `codex/skills/`: `update_plan` instead of `TaskCreate`, `apply_patch` instead of Edit, `~/.agents/skills` instead of `~/.claude/skills`, `AGENTS.md` instead of `CLAUDE.md`, `$skill-name` invocation form. The full mapping is in [`SKILL-CONVENTIONS.md`](SKILL-CONVENTIONS.md) under "Harness Vocabulary". Do not introduce Claude Code primitives here.
+ Use Codex vocabulary in `codex/skills/`: `update_plan` instead of `TaskCreate`, `apply_patch` instead of Edit, `~/.agents/skills` instead of `~/.claude/skills`, `AGENTS.md` instead of `CLAUDE.md`, `$skill-name` invocation form. The full mapping is in [`docs/harness-vocabulary.md`](docs/harness-vocabulary.md). Do not introduce Claude Code primitives here.
## Cross-Edition Sync
When changing a skill, convention, addition, or setup/update/migration file here, check whether the parallel file in [`../claude/`](../claude/) needs the same change. The two editions track each other behaviorally; vocabulary differs but principles stay aligned. Drift between editions is the most common failure mode.