Codex MD Improver
Prioritize AGENTS.md as the source of truth for Codex behavior.
Treat CLAUDE.md as optional context only.
Do not import Claude Code plugin workflows into Codex instructions.
Workflow
- Discover instruction files:
AGENTS.md, optionalCLAUDE.md, related workflow docs. - Build a contradiction map: conflicting rules, duplicate guidance, stale commands.
- Normalize around Codex execution model:
- shell-driven automation
- repository checks (lint/test/CI)
- explicit approval and safety boundaries
- Rewrite
AGENTS.mdto be concise, testable, and command-oriented. - Preserve useful knowledge from
CLAUDE.mdonly when tool-agnostic. - Output a change summary with risks and follow-up actions.
Acceptance Criteria
AGENTS.mdhas clear priorities and no conflicting rules.- Commands/paths are current and executable.
- Safety-critical actions have explicit guardrails.
- No Claude-only runtime assumptions.