What problem does it solve?
It helps you implement an already-approved plan by having Codex generate code changes phase-by-phase in a sandbox while Claude verifies that each phase stays aligned with the plan and produces coherent, expected outputs.
Core Features & Use Cases
- Phase-by-phase implementation: Executes each unchecked phase in tasks/plan.md with a controlled workflow that captures baselines, runs Codex, and evaluates results.
- Tight plan adherence via contracts: Uses explicit mismatch and blocked contracts to prevent Codex from editing when the plan premise is wrong or when the phase needs capabilities like network access.
- Robust verification gates: Enforces output schema checks, parses Codex JSON logs, detects verification-command violations, cross-checks diff scope, and updates phase checkmarks and metrics.
- Recovery and escalation: Supports mismatch re-research, blocked-state Claude takeover, and crash diagnosis with either manual escalation or a limited retry path.
Quick Start
Run implement-codex after you have a finalized tasks/plan.md and the required tasks/research-codebase.md in place, so each phase can be implemented with Codex and verified against the plan.