implement-codex

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.