Agent skill

Plan Review Gate

by romiluz13 in romiluz13/cc10x

Use after saving a non-trivial plan or decision RFC when a fail-closed feasibility, completeness, and alignment review must block execution.

MITAuto-check: notesAgent Workflows

Install Plan Review Gate

skills CLI
$ npx skills add romiluz13/cc10x --skill plan-review-gate -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install romiluz13/cc10x plan-review-gate --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/romiluz13/cc10x.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/cc10x/skills/plan-review-gate .claude/skills/plan-review-gate && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
plan-review-gate
GitHub stars
164
Token cost
~2.5k tokens
SKILL.md length
1,013 words
Files
1
Skills in repo
22
Repo updated
First seen
Licence
MIT

At a glance

Use after saving a non-trivial plan or decision RFC when a fail-closed feasibility, completeness, and alignment review must block execution.

  • Tasks that involve Human-in-the-loop approvals
  • SKILL.md covers When to Skip, The 3 Checks (Run in Sequence), Workflow and Output Format, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Plan Review Gate is an agent skill from romiluz13/cc10x. Use after saving a non-trivial plan or decision RFC when a fail-closed feasibility, completeness, and alignment review must block execution.

Its SKILL.md is about 2.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Agent Workflows, covering Human-in-the-loop approvals. The repository describes itself as: The Loop Engine for Claude Code — engineer the loop, not the prompt. 1 router · 9 agents · 16 skills · 4 workflows. Fail-closed gates, test honesty, anti-anchored review. The licence is MIT.

When your agent uses it

  • Tasks that involve Human-in-the-loop approvals

Example prompts

  • “/plan-review-gate”

Requirements

  • Pre-approved tools (allowed-tools): Read, Bash, Grep, Glob

What it can do on your machine

Read from SKILL.md and the folder at commit f346ebe. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Bash
    • Grep
    • Glob

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Plan Review Gate loads about 2.5k tokens when it runs. Until then it costs about 39 tokens; SKILL.md has 1,013 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~39
When it runs · the whole SKILL.md, loaded when a task matches
~2.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Bash, Grep, Glob

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from romiluz13/cc10x at commit f346ebe, republished under its MIT licence (© romiluz13). 1,013 words, ~2,464 tokens.

Download SKILL.mdSave it as .claude/skills/plan-review-gate/SKILL.md (or your agent's skills folder).
name
plan-review-gate
description
Use after saving a non-trivial plan or decision RFC when a fail-closed feasibility, completeness, and alignment review must block execution.
allowed-tools
Read, Bash, Grep, Glob
user-invocable
false

Spec Review Gate

Core principle: No execution plan or decision RFC reaches the user without surviving adversarial scrutiny. No leniency. "Close enough" is FAIL. A structurally neat but repo-wrong plan is FAIL.

How it works: This skill runs inline in the calling agent's context (no subagents). The calling LLM acts as an independent auditor, reads the saved artifact, and checks it against 3 criteria using Read/Grep/Glob. The value is fail-closed blocking and adversarial framing, not reviewer isolation — keep the auditor posture, but do not claim independence the gate doesn't have.

When to Skip

Skip when artifact is truly trivial: Single-file fix, copy edit, or config tweak with <3 changes and no architecture choice → return SPEC_GATE_PASS immediately.

The 3 Checks (Run in Sequence)

Check 1: Feasibility — Can this be executed against the real codebase?

Run these verifications using Read/Grep/Glob:

CriterionHow to verifyBlocking if
Artifact file exists on diskGlob(pattern="{plan_file_path}") where plan_file_path is the path from the calling agent's contextReturns 0 matches
File paths existGlob(pattern="{path}") for every referenced fileAny path returns 0 matches and doesn't exist
Codebase reality check is presentRead artifact for Codebase Reality CheckNon-trivial plan omits repo-grounded verification of existing code
Dependency orderingRead plan phases — do later phases depend on earlier ones only?Circular or forward-reference dependencies
Technical approach matches codebaseRead 1-2 existing files in the affected areaProposed patterns/libs differ from what codebase actually uses
No unstated infra assumptionsRead plan for external services, env vars, DBsPlan silently assumes infra that doesn't exist
No invented or unverified file/module assumptionsCompare claimed touched surfaces to repo realityArtifact presents guessed files/modules as verified facts
Plan mode fits the taskRead request + artifact: direct, execution_plan, or decision_rfcRequest changes ≥3 files or any contract/schema/auth surface while mode is direct; or request asks for a decision between alternatives and mode is not decision_rfc
Verification rigor fits riskCheck verification_rigor against the requested workCritical-path work is missing critical_path rigor or claims proof it never defined

Critical-path work = auth, payment, data-destructive operations, migrations, or work the user labeled critical.

Check 2: Completeness — Does it cover the full request?

Read the user's original request and compare against the plan:

CriterionHow to verifyBlocking if
All requirements mappedList each sentence of the user request; cite the plan item covering itAny user requirement has no corresponding plan item
Verification steps definedFor each plan item, find its named test, command, or checklistAny change has no way to verify it worked
Edge cases addressedFor each input surface the plan touches, find its empty, invalid, and failure caseAn input surface's empty, invalid, or failure case is neither named nor covered by an explicit "why none applies" statement
Cross-file integrationTrace each touched surface to the callers/importers the plan namesmissing touched surfaces or integration points
Plan-vs-code gaps surfacedRead the artifact for the mismatch table; spot-check one claim against the codeA non-trivial plan omits the concrete mismatch table or hides contradictions with current code
Assumption ledger is honestRead each important claim for its classification tagImportant claims are not classified as proven_by_code, inferred, or needs_user_confirmation
Phase dependency map is presentRead each phase for its depends-on/enables statementsNon-trivial phases do not say what they depend on or what they enable
Durable Decisions present for multi-phase plansFor multi-phase plans, read for a foundational-decisions sectionA multi-phase plan omits foundational decisions (routes, schema, models, auth, third-party boundaries) that all phases should reference
Decision-grade content present when neededFor decision_rfc, read for alternatives, drawbacks, and references sectionsA decision_rfc is missing alternatives, drawbacks, or references
Critical-path spec present when neededFor critical_path, read for each of the five required sectionsA critical_path artifact is missing behavior contract, edge-case catalog, provable properties, purity boundary, or verification strategy
Show full SKILL.md (379 more words)Show less
Check 3: Scope & Alignment — Is it right-sized and faithful?
CriterionHow to verifyBlocking if
Matches user requestRe-read the request; diff its ask against the plan's stated goalPlan solves different problem or adds unrequested features
No scope creepFor each plan item, name the requirement it servesExtra abstractions, refactoring, or features beyond the request
No under-scopingList the request's direct implications; find each in the planDirect implications of the request are omitted
Execution order is realWalk the phases in order; check each prerequisite exists in an earlier phasewrong execution order or missing prerequisites
Complexity proportionalFor each new file, abstraction, or dependency, cite the requirement row that needs itThe plan introduces a file, abstraction, or dependency that no requirement row maps to
Defaults are framed honestlyCheck each recommended default is listed as still-openA recommended default is treated as approved instead of still-open
Agreement fidelity holdsRead Differences from agreement; cross-check its claims against the bodyDifferences from agreement is missing, hidden, or contradicted by the body
Human layer matches execution contractCompare each summary claim to the detailed plan bodyTop summary or recommendation contradicts the detailed plan body
Hidden future work is explicitSearch the plan for "later", "follow-up", "eventually"; check each is explicit scopeUnscoped follow-on work is buried behind vague “later” language
Architecture contradictions are surfacedCompare the plan's patterns to existing ADRs and code patternscontradictions with existing architecture/patterns are hidden instead of made explicit

Workflow

text
1. Check if trivial → skip if yes (return SPEC_GATE_PASS)
2. Run Check 1: Feasibility (use Read/Grep/Glob to verify file paths)
3. Run Check 2: Completeness (read request vs plan)
4. Run Check 3: Scope & Alignment (read request vs plan)
5. Collect findings:
   - Zero BLOCKING issues across all 3 checks → SPEC_GATE_PASS
   - Any BLOCKING issue → SPEC_GATE_FAIL with specifics
   - There is no "APPROVED WITH COMMENTS" — comments get ignored; FAILs get fixed
6. IF SPEC_GATE_FAIL and iteration < 3:
   a. Present blocking issues clearly
   b. Revise the plan to address them
   c. Re-run checks (increment iteration counter)
   <!-- CC10X-M9: iteration counter is in-context only — not persisted to memory. If compaction occurs mid-retry, counter resets to 0 and gate may retry more than 3 times. Acceptable for now (gate still converges). -->
7. IF SPEC_GATE_FAIL after 3 iterations → ESCALATION: emit a blocking review result and stop — three failed revisions means the premise is wrong, not the wording

Output Format

SPEC_GATE_PASS
## Spec Gate — SPEC_GATE_PASS (iteration N of 3)

| Check | Result | Key Finding |
|-------|--------|-------------|
| Feasibility | PASS | [evidence: file paths verified / patterns match] |
| Completeness | PASS | [evidence: all N requirements mapped / required decision or proof sections present] |
| Alignment | PASS | [evidence: artifact matches request, no hidden defaults or scope creep] |
SPEC_GATE_FAIL
## Spec Gate — SPEC_GATE_FAIL (iteration N of 3)

| Check | Result | Blocking Issues |
|-------|--------|-----------------|
| Feasibility | PASS | — |
| Completeness | FAIL | [N] blocking issues |
| Alignment | FAIL | [N] blocking issues |

### Blocking Issues (MUST ADDRESS before returning PLAN_CREATED or DECISION_RFC_CREATED)
- [Check]: [specific issue with evidence]
Escalation (3/3 iterations, still failing)
## Spec Gate — ESCALATION REQUIRED (3/3 iterations exhausted)

### Remaining Blocking Issues
[List by check with evidence]

→ Do NOT question the user from this skill. Return blocking issues only. No suggestions, no softening, no collaborative rewrite advice. The planner decides how to revise or escalate.

Anti-Patterns

Anti-PatternWhy Wrong
Skipping file path verificationFabricated paths are the #1 plan failure mode
Accepting repo-agnostic summariesA clean summary is worthless if the plan ignores real code constraints
Treating SPEC_GATE_FAIL as advisoryThe gate must block PLAN_CREATED / DECISION_RFC_CREATED
Skipping for "simple" plansRead the skip criteria — only truly trivial plans qualify
Accepting SPEC_GATE_PASS without evidenceEach check needs cited proof, not "looks fine" or "seems reasonable"
Ignoring plan-vs-code contradictionsContradictions must be surfaced, not rewritten as assumptions
Reporting suggestions instead of verdictsThis gate is an auditor, not a collaborator

© romiluz13, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugins/cc10x/skills/plan-review-gate of romiluz13/cc10x.

Open the folder on GitHubat commit f346ebe

Compare with similar skills

Plan Review Gate next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Plan Review Gate compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Plan Review Gate this skillromiluz13/cc10x164—~2.5kAutomated safety check: NotesMIT
Show Me Your Work Decision Logcursor/plugins10k9 repos~1.6kAutomated safety check: PassNone
Darwin Skill Optimizeralchaincyf/darwin-skill6.2k1 repos~4.7kAutomated safety check: PassMIT
Loop Constraints Enforcercobusgreyling/loop-engineering11k1 repos~475Automated safety check: NotesMIT
Ask User QuestionMemTensor/MemOS12k—~1kAutomated safety check: PassApache-2.0
Agentmemory Forgetrohitg00/agentmemory29k—~612Automated safety check: PassApache-2.0

Similar skills

  • Official

    Keeps a TSV decision log for long or unattended agent runs, one row per decision with what, why, evidence and result, so a reviewer can check the work later.

    10k GitHub starsUsed in 9 repos~1.6k tokens
    Agent WorkflowsAuto-check passed
  • Darwin Skill Optimizer

    alchaincyf/darwin-skill

    Scores SKILL.md files on a nine-dimension rubric, then improves them in a keep-or-revert loop with independent judge agents, test prompts, git history and human checkpoints.

    6.2k GitHub starsUsed in 1 repo~4.7k tokens
    Agent WorkflowsAuto-check passed
  • Loop Constraints Enforcer

    cobusgreyling/loop-engineering

    Loads a project's loop-constraints.md before any other action and blocks pushes, edits or merges that violate the rules it defines.

    11k GitHub starsUsed in 1 repo~475 tokens
    Agent WorkflowsAuto-check: notes
  • Ask User Question

    MemTensor/MemOS

    Shows a question as a modal in the interface to clarify a task, collect a preference or get approval, since the user cannot see terminal output.

    12k GitHub stars~1k tokensUpdated 9 days ago
    Agent WorkflowsAuto-check passed
  • Agentmemory Forget

    rohitg00/agentmemory

    Deletes chosen memories from agentmemory only after showing the matches and getting an explicit yes, for privacy requests and cleanup of outdated notes.

    29k GitHub stars~612 tokensUpdated 2 days ago
    Agent WorkflowsAuto-check passed
  • Pushes an agent to keep verifying and changing approach after repeated failures, using a diagnosis line, evidence-based completion and confirmation before risky edits.

    20k GitHub stars~502 tokensUpdated 29 days ago
    Agent WorkflowsAuto-check passed

More from romiluz13/cc10x

All 22 skills in this repo
  • Building

    romiluz13/cc10x

    A skill your agent uses when writing production code test-first: the RED-GREEN-REFACTOR cycle, false-RED detection, vertical slicing, scope escalation, test process discipline, and code generation…

    164 GitHub stars~2.7k tokensUpdated yesterday
    Auto-check: notes
  • Diff Driven Docs

    romiluz13/cc10x

    A skill your agent uses when a BUILD phase completes, a commit is staged, or a PR is about to be created, and the diff has not yet been reflected in documentation.

    164 GitHub stars~2.7k tokensUpdated yesterday
    Auto-check: notes
  • Planning

    romiluz13/cc10x

    A skill your agent uses when writing an execution plan or a decision RFC: task decomposition, context references, validation levels, risk-based testing, ADR format, plan completeness gate, and…

    164 GitHub stars~2.1k tokensUpdated yesterday
    Auto-check passed
  • Verification

    romiluz13/cc10x

    A skill your agent uses when judging whether a task reached its goal, not just finished: the gate function, self-critique gate, validation levels, evidence array protocol, and goal-backward lens.

    164 GitHub stars~1.9k tokensUpdated yesterday
    Auto-check: notes
  • Agent Common

    romiluz13/cc10x

    A skill your agent uses when a cc10x agent starts a task: the shared preamble for the memory protocol, the contract format, and the output rules.

    164 GitHub stars~2k tokensUpdated yesterday
    Auto-check passed
  • Cc10x Guide

    romiluz13/cc10x

    Answers questions about cc10x itself — what it is, how to install and configure it, how the router, workflows, memory, and hooks operate, and how to troubleshoot.

    164 GitHub stars~2.2k tokensUpdated yesterday
    Auto-check passed

Categories

Questions about Plan Review Gate

What does Plan Review Gate do?

Use after saving a non-trivial plan or decision RFC when a fail-closed feasibility, completeness, and alignment review must block execution. Plan Review Gate is an agent skill from romiluz13/cc10x. Use after saving a non-trivial plan or decision RFC when a fail-closed feasibility, completeness, and alignment review must block execution.

When should I use Plan Review Gate?

Plan Review Gate fits situations like: tasks that involve Human-in-the-loop approvals.

How do I install Plan Review Gate in Claude Code?

Run `npx skills add romiluz13/cc10x --skill plan-review-gate -a claude-code`. Or copy the skill folder (plugins/cc10x/skills/plan-review-gate in romiluz13/cc10x) into .claude/skills/plan-review-gate in your project. Claude Code loads it when a task matches its description.

How do I install Plan Review Gate in Codex?

Run `npx skills add romiluz13/cc10x --skill plan-review-gate -a codex`. Or copy the skill folder (plugins/cc10x/skills/plan-review-gate in romiluz13/cc10x) into .agents/skills/plan-review-gate in your project. Codex loads it when a task matches its description.

Can I use Plan Review Gate in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add romiluz13/cc10x --skill plan-review-gate -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/plan-review-gate, .gemini/skills/plan-review-gate, .github/skills/plan-review-gate and .opencode/skills/plan-review-gate in your project.

What does Plan Review Gate need to run?

SKILL.md names no scripts, command-line tools or credentials: Plan Review Gate is instructions for the agent only. Its frontmatter pre-approves these tools: Read, Bash, Grep, Glob.

Does Plan Review Gate access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Plan Review Gate safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Plan Review Gate use?

Plan Review Gate is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Plan Review Gate use?

About 2.5k tokens (SKILL.md is roughly 9.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Plan Review Gate?

Skills that share tags, products or a category with Plan Review Gate: Show Me Your Work Decision Log (cursor/plugins, 10k stars), Darwin Skill Optimizer (alchaincyf/darwin-skill, 6.2k stars), Loop Constraints Enforcer (cobusgreyling/loop-engineering, 11k stars) and Ask User Question (MemTensor/MemOS, 12k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Plan Review Gate?

romiluz13 (a GitHub user) maintains it in romiluz13/cc10x, which has 164 GitHub stars. The repository holds 22 skills in this directory. The repository was last updated on October 7, 2026.

Source: romiluz13/cc10x on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.