Task AI workflow template: Any work item, intake to verified.

The Task template makes your AI handle any work item with the same six steps: confirm a title and summary, write a one-screen plan you approve, implement it surgically, verify against the plan, and capture anything non-obvious it learned. You approve twice, and a failed verification returns to Implement.

6 steps · 2 approvals · 1 loop back

Task · example runyour AI client
  1. 01Intake
  2. 02Analyzeyou approve
  3. 03Implementdeveloper
  4. 04Verifyyou approve
  5. 05Capture Learnings
  6. 06Completeclosing note
task created · workflow attached

example · the steps are this template's real steps

in short

What does the Task template do?

For anyone who hands everyday work to an AI (refactors, doc updates, research) and wants a plan before the change and a check after it.

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 two approvals until a person says yes.

  • Refactor an authentication module with review before it ships
  • Update API documentation from request to verified change
  • Research competitor pricing and capture the findings for next time
step by step

How does the Task workflow run?

6 steps, in this order. Below each one is the instruction your AI receives at that step, exactly as the template stores it.

Intake
Analyzeapproval
Implementdeveloper
Verifyapproval
Capture Learnings
Completeclosing note
  1. 01

    Intake

    the agent works

    Confirm the task has a clear title and a one-line summary. If either is missing, pause and ask the operator. Do not advance until both are present.

  2. 02

    Analyze

    waits for your approvalrole · planner

    Write a short plan: the minimum needed to know what to build and what could go wrong. One screen of text, not a document.

    Cover:

    • What we're doing and why
    • Files likely to change
    • Obvious risks
    • How we'll verify it worked

    Ask the operator to approve the plan before moving on.

    no rejection path · the run moves on only when approved

  3. 03

    Implement

    the agent worksrole · developer

    Execute the plan from the previous step. Keep changes surgical: don't scope-creep into adjacent code.

    When finished, move to verify.

  4. 04

    Verify

    waits for your approvalrole · reviewer

    Run the verification you defined in the plan. Report what you ran, what passed, what didn't. If something failed, go back to implement and fix it before asking for approval.

    Ask the operator to approve before moving on.

    rejected → back to Implement

  5. 05

    Capture Learnings

    the agent works

    If anything non-obvious came up, write a short note to:

    docs/learnings/{YYYY-MM-DD}-{task-slug}.md

    Use plain Markdown. Skip if nothing non-obvious happened.

  6. 06

    Complete

    closes with a note

    Task done. Close it out.

where a person decides

Where do you approve in Task?

Two steps wait for a person. You answer in the chat; the engine records the verdict and the audit row records who gave it.

step 2

Analyze

The plan fits on one screen: what and why, files likely to change, obvious risks and how it will be verified. You approve it before anything changes.

what you review

  • What we're doing and why
  • Files likely to change
  • Obvious risks
  • How we'll verify it worked

no rejection path · approve to continue

step 4

Verify

Your AI runs the verification it promised in the plan and reports the result. Reject it and the run returns to Implement.

reject → back to Implement

gates the engine checks without you

  • Complete closes only when your AI leaves a closing note. The note is saved to the task as context, so later work can find why it ended the way it did.
what you need

What do you need to run Task?

Read from the template's own steps: the tools they call, the files they write, and whether they touch code.

An AI client
Claude Code, Claude (desktop, web, Cowork), OpenAI Codex, ChatGPT, Cursor, OpenCode, or any MCP client, or an isolated run ConvOps starts. Either way the model is yours.
ConvOps
A workspace with Task installed. It attaches to the task task type, so new work of that type starts on it.
Tools your AI calls
workflow_advance to move between steps.
Where the work lands
Files in your repository: docs/learnings/{YYYY-MM-DD}-{task-slug}.md.
A repository
Yes. Steps read and change code, so run it in a coding client with your repo checked out (Claude Code, Codex, Cursor, OpenCode).
Roles named in steps
planner, developer, reviewer. A hint for clients with subagents; one AI can run every step.
make it yours

How do you customize Task?

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.

Claude Codeexample

new chat

more example prompts

  • "Remove the Analyze approval: I only want to approve at Verify."
  • "In Capture Learnings, write the note to our wiki folder instead of docs/learnings/."
  • "Add an Intake rule: every task names the project it belongs to."
the difference

Task: without a workflow vs with it

  • Ad-hoc requests get started, half-finished, and silently dropped
  • No record of what was done or why a decision was made
  • What one person learned never reaches the next person doing similar work
  • The process lives in a prompt, and each run follows it a little differently
questions

Task template FAQ

How is the Task template different from Bug Fix?

Task plans first and implements against that plan. Bug Fix reproduces and finds a root cause before any fix, and requires a regression test. Task attaches to the task type, Bug Fix to the bug type.

Where do learnings go?

Capture Learnings writes a short Markdown note to docs/learnings/{YYYY-MM-DD}-{task-slug}.md when something non-obvious came up, and skips the step otherwise. The closing note your AI leaves at Complete is saved to the task as context.

Is it only for code?

No. The steps are generic: intake, a plan, the work, a check. The catalog examples include refactoring an auth module, updating API docs and researching competitor pricing.

Which AI clients can run the Task template?

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.