Review
Your AI has summarized what changed, why, and what could go wrong. Approve to continue, or reject to send the plan to Apply Fixes and back to you.
reject → back to Apply Fixes
The Plan template makes your AI write an implementation plan as files, put it in front of you through an embedded review fragment, create one child task per phase, and hold until every phase is finished. Three approvals sit on the path: the review, the go-ahead and the final verify.
10 steps · 3 approvals · 2 loops back · waits for child tasks
example · the steps are this template's real steps
For teams who want an AI to plan migrations, roadmaps and refactors as reviewable documents before any phase starts.
It is a stored workflow, not a prompt. Your AI client receives one step at a time from ConvOps over MCP, does the work, and advances. The engine holds the run at each of its three approvals until a person says yes.
10 steps, in this order. Below each one is the instruction your AI receives at that step, exactly as the template stores it.
Analyze the plan's scope and approach. Read the parent initiative for goal alignment and constraints.
Produce docs/plans/{task-slug}/analysis.md with:
Keep each section tight. The draft step expands the plan; analysis captures the shape.
Draft the plan as files under docs/plans/{task-slug}/.
Create:
overview.md: title, one-paragraph outcome, enumerated phase list (title + one-line summary each), sequencing notes if order matters, and a plain-English acceptance statement for the plan as a wholephases/, named phase-NN-short-slug.md (NN is a zero-padded index, slug is a short kebab-case phase name). Each file contains: Scope (what this phase delivers and what it excludes), Approach (the work to do), Verification (how to confirm this phase is done)Prefer fewer, broader phases over many narrow ones. Do NOT create phase tasks yet: that is the next step.
embedded fragment · review-and-approve · a reusable block the engine runs in place
Summarize the decision the operator needs to make in one paragraph. Include:
Keep it under 10 lines. Do not restate the whole task.
Apply the changes the operator requested, then advance with workflow_advance (no approved verdict). Do not make changes the operator did not ask for.
Present the prepared decision to the operator. Approve with workflow_advance(approved=true) to continue; reject with workflow_advance(approved=false) to send it for fixes. Never record a verdict the operator did not give.
rejected → back to Apply Fixes
Create one child task per phase defined in docs/plans/{task-slug}/phases/. For each phase file:
Attach every phase task to this plan as the parent. Confirm all phase tasks were created and linked before advancing.
Plan and phase tasks exist. Request operator go-ahead before advancing to execute-phases: this lets the parent initiative pipeline sequence plans.
no rejection path · the run moves on only when approved
Phase execution is in progress. This step blocks until every child phase reaches a terminal state (completed or cancelled). Address stalls on the phase's own workflow: not here.
Validate the plan's integration. Each phase was verified in isolation; confirm they combine into the plan's promised outcome. Report scenario exercised, what worked, what didn't, and which phase owns any gap. Reject to reopen execute-phases. Request operator approval before advancing.
rejected → back to Execute Phases
Plan shipped. Mark it complete.
Three steps wait for a person. You answer in the chat; the engine records the verdict and the audit row records who gave it.
Your AI has summarized what changed, why, and what could go wrong. Approve to continue, or reject to send the plan to Apply Fixes and back to you.
reject → back to Apply Fixes
Phase tasks exist but nothing runs yet. Your go-ahead lets a parent initiative sequence its plans.
no rejection path · approve to continue
Every phase was verified alone. Here you confirm they combine into the outcome the plan promised. Reject it and the run returns to Execute Phases.
reject → back to Execute Phases
gates the engine checks without you
Read from the template's own steps: the tools they call, the files they write, and whether they touch code.
Connect your AI client first, then install Plan from the catalog in the ConvOps app. See how to connect a client
An installed template is a workflow in your workspace. Ask your AI to change it in plain words; the edit lands on the one step that needs it.
new chat
more example prompts
Analyze writes docs/plans/{task-slug}/analysis.md. Draft writes overview.md in the same folder plus one phase-NN-short-slug.md file per phase under phases/, each with scope, approach and verification.
A reusable three-step block embedded in the plan: Prepare Review summarizes the decision, Review asks you, and a rejection goes to Apply Fixes, which applies only what you asked for and returns to the review. The same fragment can be embedded in other workflows.
Create Phases makes one child task per phase file, each starting in backlog on its own Phase workflow. Execute Phases waits until every child phase is completed or cancelled.
Any MCP client connected to ConvOps. Verified clients: Claude Code, Claude (desktop, web, Cowork), OpenAI Codex, ChatGPT, Cursor, OpenCode. Because its steps change code, run it in a coding client with your repository checked out.