What problem does it solve?
This Skill prevents low-quality plans from persisting by repeatedly re-planning and re-reviewing until only acceptable risk remains, specifically removing any remaining HIGH concerns before proceeding.
Core Features & Use Cases
- Cross-AI external review loop: Runs plan review with selectable AI CLI reviewers (e.g., Codex, Gemini, Claude, OpenCode) and optionally local model servers (Ollama, LM Studio, llama.cpp).
- Replan with targeted review feedback: When HIGH concerns are detected, it re-invokes the planning phase using the
--reviews feedback to drive convergence.
- Controlled convergence safeguards: Enforces workflow gates, revision-loop behavior, stall detection, and escalation boundaries, stopping when no HIGH concerns remain or when
--max-cycles is reached.
- Use Case: You generate an engineering plan, have multiple AI reviewers check it for high-risk issues, and automatically iterate until the remaining issues are no longer classified as HIGH.
Quick Start
Use gsd-plan-review-convergence with a specific phase number by running it as gsd-plan-review-convergence <phase> --codex --max-cycles 3.