Menu
Cross-AI plan convergence - replan until review concerns are resolved.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Bidirectional VCS migration: rewrites .planning/ revision ids and flips vcs.adapter atomically.
config workspace | workstreams thread update ship inbox
File a phase artifact into MemPalace; mirror decision facts into its temporal KG
Generate an AI-SPEC.md design contract for phases that involve building AI systems.
Start a new milestone cycle — update PROJECT.md and route to requirements
Create detailed phase plan (PLAN.md) with verification loop
Based on SOC occupation classification
| name | gsd-plan-review-convergence |
| description | Cross-AI plan convergence - replan until review concerns are resolved. |
| argument-hint | <phase> [--codex] [--gemini] [--claude] [--opencode] [--ollama] [--lm-studio] [--llama-cpp] [--text] [--ws <name>] [--all] [--max-cycles N] |
| allowed-tools | ["Read","Write","Bash","Glob","Grep","Agent","Skill","AskUserQuestion"] |
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.
<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>
Flags:
--codex — Use Codex CLI as reviewer (default if no reviewer specified)--gemini — Use Gemini CLI as reviewer--claude — Use Claude CLI as reviewer (separate session)--opencode — Use OpenCode 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)--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