plan

A planning-only workflow that turns a rough work request into a reviewer-approved plan saved in a session file. It stops before implementation and provides a way to resume later.

In plain words
What is it for?
Use it when you want to plan a feature, fix, or other work item without immediately implementing it. It runs drafting and review cycles until the plan is approved.
Why use it?
It lets you refine the approach and catch problems before code is changed. Keeping the plan in a shared file makes it available to a later execution step or another coding tool.

Skill for Claude CodeCodex

Part of the review-loop plugin — 7 skills, 12 agents shipped together

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.

agentmods
npx agentmods add skills/nytc69/review-loop/plan
Any agent
npx skills add NYTC69/review-loop --skill plan
Clone the repo
git clone --depth 1 https://github.com/NYTC69/review-loop

Made for: Claude Code, Codex.

Or install review-loop, the plugin that ships this one along with the rest of its 7 skills, 12 agents.

Per session 65 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 4,559 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. Scan, not verified.
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 $0.00065 $0.04559
Opus 5 $0.00032 $0.02279
Sonnet 5 $0.00013 $0.00912
Haiku 4.5 $0.00006 $0.00456

Measured 3d ago against content hash 77e92240983f, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

plan scanned grade A 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 3d 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.

Runs shell commandslowCapability

Expected in a hook, worth knowing in a rule or an instructions file.

the scheduler via `subprocess.PIPE` and surfaced through each
.agents/skills/plan/SKILL.md · 405 lines

How it starts

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

plan — Codex Stage 1 Planning Sub-Skill

Drive a work item through the Plan loop (Executor drafts → Reviewer critiques → iterate) until the Reviewer returns APPROVE, then stop. This skill does not enter the execution phase; it hands off to review-loop:execute --session <uuid> (or to a different runtime's execute skill) via the shared session file.

Stage 1 Scope

  • Codex Stage 1 follows the same broad exec -> polish -> docs -> security -> delivery lifecycle.
  • Codex Stage 1 assumes a single orchestrator-owned workspace for the session.
  • Included: planning-phase orchestration, shared .review-loop/config.md, shared .review-loop/sessions/*.md, Claude CLI default reviewer, optional local Codex reviewer, shared reviewer schema, Stage 1 hallucination guards.
  • Excluded: execution loop, Quality Polish, Documentation Consistency, Security Preflight, Delivery — those live in .agents/skills/execute/SKILL.md.

Protocol Imports

The Orchestrator MUST Read each of these files at start. They are the single source of truth for this skill's planning loop and output schemas.

  • docs/protocol/session-file.md
  • docs/protocol/planning.md
  • docs/protocol/executor-output.md
  • docs/protocol/reviewer-output.md

Do not re-derive any rule that already lives in a protocol doc. When a step below says "see docs/protocol/<doc>.md §Foo", follow that doc verbatim. The startup read set is complete only after all 4 docs above have been read explicitly; embedded executor/reviewer prompt bodies are not a substitute for reading executor-output.md and reviewer-output.md.

Runtime Identity

  • Codex is the orchestrator. Do not do the planning or coding in the main thread.
  • The orchestrator is the only writer of .review-loop/sessions/{uuid}.md.
  • review_loop_executor never writes the session file directly.
  • review_loop_reviewer never writes the session file directly.
  • Do not create or switch to another git worktree or repository checkout.
  • When invoking Codex subagents, use a fresh self-contained prompt that embeds the required task context directly. Do not rely on inherited or forked parent thread context.
  • Reject malformed Executor or Reviewer output instead of guessing.

Read the full file on GitHub · 405 lines

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. 3d ago First seen · 405 lines · 65 tokens per session scan A 77e92240983f

Subscribe to this mod's changes

plan is a skill published in the GitHub repository NYTC69/review-loop (3 stars, last pushed 3mo ago), licensed Apache-2.0. It adds 65 tokens to every session and 4,559 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 1 finding (runs shell commands). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

codex-adversarial-review-lite

Codex Adversarial Review - Lite: user-invoked audit workflow for Claude Code users who want Codex CLI to independently review AI-generated code, plans, test expectations, and scope before fixes are applied. Cross-platform (Windows, macOS, Linux, WSL). Use only when the user explicitly invokes audit or selftest.

razaumair2203-ux/codex-adversarial-review-lite · 76 tokens

codex-handoff

Three-phase collaboration workflow between Claude Code (planner/decision-maker) and Codex CLI (implementer/reviewer) via the codex-plugin-cc plugin. Use whenever a coding task involves multiple files, new modules, cross-cutting refactors, business logic changes, or anything that warrants a written spec and a review…

ParaGenie/claude-codex-handoff · 175 tokens

brain-docs

Set up and maintain a "project brain" — a brain/ folder holding three living documents (decisions.md, flow.md, todo.md) that give a project persistent memory across chat sessions. Use this skill whenever the user wants a decision log, architecture/flow notes, project memory, living documentation, or notes that survive…

IAbhishekJhaI/brain · 162 tokens

codex-handoff

Three-phase collaboration workflow between Claude Code (planner/decision-maker) and Codex CLI (implementer/reviewer) via the codex-plugin-cc plugin. Use whenever a coding task involves multiple files, new modules, cross-cutting refactors, business logic changes, or anything that warrants a written spec and a review…

ParaGenie/claude-codex-handoff · 175 tokens

security-ownership-map

Analyze git repositories to build a security ownership topology (people-to-file), compute bus factor and sensitive-code ownership, and export CSV/JSON for graph databases and visualization. Trigger only when the user explicitly wants a security-oriented ownership or bus-factor analysis grounded in git history (for…

HKUDS/DeepCode · 99 tokens

seo-image-gen

AI image generation for SEO assets: OG/social preview images, blog hero images, schema images, product photography, infographics. Powered by Gemini via nanobanana-mcp. Requires banana extension installed. Use when user says "generate image", "OG image", "social preview", "hero image", "blog image", "product photo"…

AgriciDaniel/claude-seo · 111 tokens