mcpField
I
implement-spec-with-codex

implement-spec-with-codex

github.com/dzhngAgent workflows1.4k246 installsUpdated today
Repository

About implement-spec-with-codex

A skill that runs the implement-spec process while delegating code implementation to Codex. It is for developers orchestrating specification-driven work who want to retain responsibility for planning, integration, verification, and review.

Key features

  1. 01Delegate implementation through codex exec
  2. 02Split independent work into concurrent worktrees
  3. 03Keep planning and integration with the orchestrator
  4. 04Review diffs and run verification gates
  5. 05Verify visual changes in a browser

Use cases

  1. 01Implementing a specification in reviewable slices
  2. 02Running independent implementation tasks concurrently
  3. 03Checking visual changes against the production render path
  4. 04Preparing and reviewing a merged change before commit

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/dzhng/skills --skill implement-spec-with-codex

After installing, type/implement-spec-with-codexin Claude Code to confirm it loaded.

Details

From the project README

Implement Spec with Codex

Run implement-spec exactly — same loop, same gates, same maintenance checkpoints — but Codex writes the code. Invoking this skill IS the explicit ask that authorizes codex exec delegation under the codex skill.

Role split

  • Codex implements — whenever possible. Default every implementation pass to a codex exec, sliced sharp and prompted per the codex skill (prompt blocks, sandbox choice, exec liveness). Run independent slices as concurrent execs in separate worktrees, exactly where implement-spec would fan out subagents.
  • You orchestrate and review. The spec loop stays yours: pick the next slice, reconcile plan with code, author each prompt end-to-end, integrate diffs, run the gates, review the merged tree, commit, update the handoff, run maintenance checkpoints. None of that delegates.

Keep a pass yourself only when slicing it sharply would cost more than doing it — tiny fixups, plan reconciliation, integration conflicts.

Rules

  • You own every result: read the full diff and run the verification yourself. "Codex says it's done" is never done.
  • Visual results carry implement-spec's two extra proofs (production-route pixel diff + unprimed critique) with double force here: a sandboxed Codex never saw its change render, so a pass that misses the production render path entirely arrives looking fully "verified".
  • A sandboxed Codex ships code it never saw run — browser-verify every visual slice yourself and budget fix rounds. Send a red gate back as a resumed follow-up with the failing evidence; fix it yourself only when that's smaller than re-prompting.
  • Commit hygiene stays yours: review the change list of the merged tree before every commit, exactly as implement-spec demands of the integrating reviewer.

Comments

Markdown supported