How do I install the Gsd Plan Review Convergence skill?

Run npx skillmds@latest add open-gsd/gsd-plan-review-convergence in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Gsd Plan Review Convergence skill do?

Cross-AI plan convergence - replan until review concerns are resolved. It is listed under Coding & Dev Tools on SkillMD.

Is Gsd Plan Review Convergence safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Gsd Plan Review Convergence?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Gsd Plan Review Convergence free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Gsd Plan Review Convergence?

open-gsd (@open-gsd) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Gsd Plan Review Convergence by open-gsd

Name: Gsd Plan Review Convergence
Rating: 4.666666666666667 (3 reviews)
Author: open-gsd

File contents

Flow: Skill("gsd-plan-phase") → Agent→Skill("gsd-review") → check unresolved HIGH + actionable non-HIGH → Skill("gsd-plan-phase --reviews") → Agent→Skill("gsd-review") → ... → Converge or escalate

Replaces gsd-plan-phase's internal gsd-plan-checker with external AI reviewers (codex, gemini, etc.). Plan-phase runs inline (bare Skill at depth 0) so it can spawn gsd-planner/gsd-plan-checker at depth 1. Review runs inside an isolated Agent (gsd-review is a Bash leaf — no sub-agents needed). Orchestrator only does loop control.

Orchestrator role: Parse arguments, validate phase, run plan-phase inline (Skill at depth 0), spawn an Agent for gsd-review, check unresolved HIGH and actionable non-HIGH counts, stall detection, escalation gate.

Flags:

--codex — Use Codex CLI as reviewer (default if no reviewer flag given AND review.default_reviewers is unset; otherwise review.default_reviewers wins per ADR-0011 — #2315)
--gemini — Use Gemini CLI as reviewer
--agy / --antigravity — Use Antigravity CLI as reviewer (successor to the discontinued Gemini CLI)
--claude — Use Claude CLI as reviewer (separate session)
--coderabbit — Use CodeRabbit as reviewer (reviews the working-tree diff, not the source tree)
--opencode — Use OpenCode as reviewer
--qwen — Use Qwen Code CLI as reviewer (Alibaba Qwen models)
--cursor — Use Cursor agent as reviewer
--ollama — Use local Ollama server as reviewer (OpenAI-compatible, default host http://localhost:11434; configure model via review.models.ollama)
--lm-studio — Use local LM Studio server as reviewer (OpenAI-compatible, default host http://localhost:1234; configure model via review.models.lm_studio)
--llama-cpp — Use local llama.cpp server as reviewer (OpenAI-compatible, default host http://localhost:8080; configure model via review.models.llama_cpp)
--kimi-code — Use Kimi Code CLI as reviewer (Moonshot AI)
--all — Use all available CLIs and running local model servers
--max-cycles N — Maximum replan→review cycles (default: 3)

Feature gate: This command requires workflow.plan_review_convergence=true. Enable with: gsd config-set workflow.plan_review_convergence true

---name: gsd-plan-review-convergencedescription: Cross-AI plan convergence - replan until review concerns are resolved.--- <objective> Cross-AI plan convergence loop — an outer revision gate around gsd-review and gsd-planner. Repeatedly: review plans with external AI CLIs → if HIGH or actionable non-HIGH concerns remain → replan with --reviews feedback → re-review. Stops when no unresolved HIGH concerns or actionable MEDIUM/LOW findings remain outside PLAN.md, or when max cycles is reached. **Flow:** Skill("gsd-plan-phase") → Agent→Skill("gsd-review") → check unresolved HIGH + actionable non-HIGH → Skill("gsd-plan-phase --reviews") → Agent→Skill("gsd-review") → ... → Converge or escalate Replaces gsd-plan-phase's internal gsd-plan-checker with external AI reviewers (codex, gemini, etc.). Plan-phase runs **inline** (bare Skill at depth 0) so it can spawn gsd-planner/gsd-plan-checker at depth 1. Review runs inside an isolated Agent (gsd-review is a Bash leaf — no sub-agents needed). Orchestrator only does loop control. **Orchestrator role:** Parse arguments, validate phase, run plan-phase inline (Skill at depth 0), spawn an Agent for gsd-review, check unresolved HIGH and actionable non-HIGH counts, stall detection, escalation gate. </objective> <execution_context> @$HOME/.claude/gsd-core/workflows/plan-review-convergence.md @$HOME/.claude/gsd-core/references/revision-loop.md @$HOME/.claude/gsd-core/references/gates.md @$HOME/.claude/gsd-core/references/agent-contracts.md </execution_context> <runtime_note> **Copilot (VS Code):** Use `vscode_askquestions` wherever this workflow calls `AskUserQuestion`. They are equivalent — `vscode_askquestions` is the VS Code Copilot implementation of the same interactive question API. Do not skip questioning steps because `AskUserQuestion` appears unavailable; use `vscode_askquestions` instead. </runtime_note> <context> Phase number: extracted from $ARGUMENTS (required) **Flags:** - `--codex` — Use Codex CLI as reviewer (default if no reviewer flag given AND `review.default_reviewers` is unset; otherwise `review.default_reviewers` wins per ADR-0011 — #2315) - `--gemini` — Use Gemini CLI as reviewer - `--agy` / `--antigravity` — Use Antigravity CLI as reviewer (successor to the discontinued Gemini CLI) - `--claude` — Use Claude CLI as reviewer (separate session) - `--coderabbit` — Use CodeRabbit as reviewer (reviews the working-tree diff, not the source tree) - `--opencode` — Use OpenCode as reviewer - `--qwen` — Use Qwen Code CLI as reviewer (Alibaba Qwen models) - `--cursor` — Use Cursor agent as reviewer - `--ollama` — Use local Ollama server as reviewer (OpenAI-compatible, default host `http://localhost:11434`; configure model via `review.models.ollama`) - `--lm-studio` — Use local LM Studio server as reviewer (OpenAI-compatible, default host `http://localhost:1234`; configure model via `review.models.lm_studio`) - `--llama-cpp` — Use local llama.cpp server as reviewer (OpenAI-compatible, default host `http://localhost:8080`; configure model via `review.models.llama_cpp`) - `--kimi-code` — Use Kimi Code CLI as reviewer (Moonshot AI) - `--all` — Use all available CLIs and running local model servers - `--max-cycles N` — Maximum replan→review cycles (default: 3) **Feature gate:** This command requires `workflow.plan_review_convergence=true`. Enable with: `gsd config-set workflow.plan_review_convergence true` </context> <process> Execute end-to-end. Preserve all workflow gates (pre-flight, revision loop, stall detection, escalation). </process>

Frequently asked questions

Gsd Plan Review Convergence