From synapse-review
Adversarial plan review: Claude Code creates a plan, Codex/Cursor reviews it critically, iterate until approved. Use when the user says /plan-review, "review plan", "审查计划", or needs a technical plan vetted by a second AI agent.
How this skill is triggered — by the user, by Claude, or both
Slash command
/synapse-review:plan-reviewThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Claude Code creates a technical plan, then delegates adversarial review to Codex (or Cursor). The reviewer's role is to find flaws. Iterate until the plan is solid.
Claude Code creates a technical plan, then delegates adversarial review to Codex (or Cursor). The reviewer's role is to find flaws. Iterate until the plan is solid.
.worktree-spec.md existsKNOWN_ISSUES.md for issues relevant to the current task (if it exists)./plans/ (create if it doesn't exist)./traces/<task-name>/trace.md./plans/plan-{timestamp}.md containing:
Via MCP (preferred):
Call the codex MCP tool with:
PROMPT: Full plan text + review instructions:
"Review this technical plan critically. Evaluate from 5 dimensions:
- Technical Feasibility — can this actually work?
- Completeness — are there missing steps or edge cases?
- Risk Assessment — what could go wrong?
- Maintainability — will this be easy to maintain?
- Performance — are there performance concerns?
For each issue found, tag severity: CRITICAL / HIGH / MEDIUM / LOW. Be adversarial — your job is to find problems."
cd: current working directorysandbox: "read-only"return_all_messages: trueSESSION_ID for follow-up roundsVia Shell fallback (if MCP unavailable):
bash <plugin-scripts-dir>/ask_codex.sh "<review-prompt>" read-only "<working-dir>"
./plans/plan-{timestamp}-v{N}.md./plans/review-{timestamp}-round{N}.md### EARS — Checkpoint ({timestamp})
- Discovery: Codex review found {N} issues, {M} CRITICAL
- Decision: Revised {list}, kept {list} (rationale: ...)
- Status: Round {N} complete, {pending} issues remaining
.worktree-spec.md context section → output final plan path.worktree-spec.md Context sectionIf synapse-ears is installed:
traces/<task>/trace.mdIf synapse-ears is NOT installed, skip EARS entries.
npx claudepluginhub chosenx-gpu/synapse --plugin synapse-reviewOrchestrates parallel architecture and experience reviews of implementation plans, scores findings across dimensions like data flow and UX, consolidates ranked fixes for user approval and auto-application. Use after planning, before non-trivial coding.
Reviews implementation Plan files in parallel using Codex, Gemini, and Claude to analyze validity, gaps, risks, and improvements. Invoke via /plan-review after plan creation.
Invokes Codex to review implementation plans for gaps, risks, suboptimal steps, and alternatives. Triggered after Claude plans or on requests for second opinions.