dev-review

dev-review is a skill for Claude Code from alanshurafa/co-evolution. It costs 176 tokens per session (7,762 once invoked), scanned B, original, MIT.

A workflow for planning and reviewing code changes between Claude Code and Codex CLI, two coding-agent tools. The plan is exchanged for refinement before the final version is executed in the repository.

In plain words
What is it for?
Use it to create a code-change plan, have another agent challenge or clarify it, refine the plan, execute the approved work, and verify the result.
Why use it?
It provides a structured review loop before code is changed, helping resolve disagreements or unclear requirements early. It also supports verification after execution.

Skill for Claude Code

Written for Claude Code: allowed-tools in frontmatter. Also seen: reads .claude/ paths; mentions subagents; positional $N argument.

Good fit Use it to create a code-change plan, have another agent challenge or clarify it, refine the plan, execute the approved work, and verify the result.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/alanshurafa/co-evolution/dev-review
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add alanshurafa/co-evolution --skill dev-review
Clone the repo
git clone --depth 1 https://github.com/alanshurafa/co-evolution

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for dev-review

README.md
[![agentmods](https://agentmods.dev/badge/skills/alanshurafa/co-evolution/dev-review/github.svg)](https://agentmods.dev/skills/alanshurafa/co-evolution/dev-review)
Your own site
<a href="https://agentmods.dev/skills/alanshurafa/co-evolution/dev-review"><img src="https://agentmods.dev/badge/skills/alanshurafa/co-evolution/dev-review/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for dev-review

Your own site · 80×15
<a href="https://agentmods.dev/skills/alanshurafa/co-evolution/dev-review"><img src="https://agentmods.dev/badge/skills/alanshurafa/co-evolution/dev-review.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 176 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 7,762 The whole file, excluding the scripts and references it only reads on demand.
Security scan B 1 finding. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00176 $0.07762
Opus 5.5 $0.00070 $0.03105
Sonnet 5.5 $0.00035 $0.01552
Haiku 4.5 $0.00018 $0.00776

Measured 23d ago against content hash 1a34da6f3bd7, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade B, and why

dev-review scanned grade B with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 23d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Reads agent configuration directoriesmediumAgent snooping

.claude/, .codex/, .gemini/ hold keys, settings and other credentials a mod has no legitimate need for.

own `~/.codex/config.toml` defaults.
skills/dev-review/SKILL.md · 795 lines

How it starts

The opening of the file, as written. The whole thing — 795 lines — stays where its author put it; the contents beside it link to each section on GitHub.

/dev-review - Plan-Bounce-Execute Workflow

Automates the workflow of composing a code plan with one AI, bouncing it between agents for refinement using [CONTESTED]/[CLARIFY] markers, then having one agent execute the final plan into code. Replaces manual copy-paste between Claude Code and Codex.

Use /co-evolution for general questions, ideas, arguments, prompt refinement, or document bounces. Use /dev-review only when the intended deliverable is a repo change or code-focused verification workflow.

For the detached flavor — the session plans and reviews while Codex executes in the background and the session is woken at gates instead of babysitting — use /codex-build (skills/codex-build/). It kicks the standalone runner with --preset codex-build (Opus plans at high, Codex executes at xhigh, Opus reviews at max; --verify on, bounces 2, revise-loop 1) and applies a schema-bound ACCEPT / REVISE / ESCALATE gate. /dev-review is the interactive single-session loop; /codex-build is the same pipeline run detached.

When --live is enabled on Windows, each Codex pass runs in a visible PowerShell window so the user can watch progress in real time. The handoff contract stays file-based: prompts are written to disk, Codex writes the final message to disk, and Claude Code reads the resulting artifact before continuing.

The workflow has three phases:

  1. Compose - One agent creates the initial plan/approach
  2. Bounce - The plan document bounces between agents, each editing it directly
  3. Execute - The designated agent writes the final code from the refined plan

Step 1: Parse Arguments

Parse $ARGUMENTS for:

/dev-review [--composer opus|codex] [--executor opus|codex] [--bounces N|auto] [--verify] [--worktree] [--model MODEL] [--skip-plan] [--plan-only] [--live] <task description>

Defaults:

  • --composer opus (Opus creates the initial plan)
  • --executor codex (Codex writes the final code)
  • --bounces auto (bounce until convergence — zero [CONTESTED] and zero [CLARIFY] markers — up to a max of 6 passes. If not converged after 6, stop and ask the user to arbitrate the remaining markers. Use --bounces N to override with a fixed count.)
  • --verify if set, adds a final code review pass after execution
  • --model overrides Codex model
  • --worktree creates isolated worktree
  • --skip-plan jumps straight to code execution (backward compat with old behavior)
  • --plan-only stops after the bounce phase, outputs the refined plan
  • --live opens visible Windows terminal windows for Codex passes; if unavailable, warn once and fall back to the current headless behavior
  • Remaining text = task description

Read the full file on GitHub · 795 lines

Files

What ships with it

8 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 23d ago Changed · -1 lines 1a34da6f3bd7
  2. 1mo ago Changed 3827a89594b3
  3. 1mo ago First seen · 796 lines · 176 tokens per session scan B 684228be8f19

Subscribe to this mod's changes

dev-review is a skill published in the GitHub repository alanshurafa/co-evolution (4 stars, last pushed 20d ago), licensed MIT. It adds 176 tokens to every session and 7,762 once invoked, about $0.0007 per session on Opus 5.5. A static security scan graded it B with 1 finding (reads agent configuration directories). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.