Skip to content
Moira Documentation

Task Breakdown Flow

Workflow for executing multi-step tasks with mandatory evidence requirements and verification loops. Each step must be self-sufficient and produce verifiable output.

Start

Section titled “Start”
Terminal window
mcp__moira__start({ workflowId: "task-breakdown-flow" })

Process

Section titled “Process”
flowchart LR
    A[Understand] --> B[Decompose]
    B --> C[Validate]
    C --> D[Approve]
    D --> E[Execute]
    E --> F[Verify Step]
    F --> G{More Steps?}
    G -->|Yes| E
    G -->|No| H[Deliver]

Steps

Section titled “Steps”
StepActionOutput
1. UnderstandCollect requirements: task, deliverable, constraints, success criteriaClear task definition
2. DecomposeBreak into 3-10 concrete steps with expected_outputSelf-sufficient step list
3. ValidateAutomatic check for step self-sufficiencyValidated plan
4. ApproveUser confirms plan before executionApproved plan
5. ExecuteExecute each step with evidenceStep artifacts
6. Verify StepVerify each step against expected_outputVerified completion
7. DeliverFinal result with all evidenceComplete deliverable

Features

Section titled “Features”

Self-Sufficient Steps

Section titled “Self-Sufficient Steps”

Each step contains all information needed for execution without full plan context:

  • File paths and locations
  • Specific actions to perform
  • Expected output format

Evidence Required

Section titled “Evidence Required”
Evidence TypeExample
ScreenshotUI state verification
FileCreated or modified files
LinkPublished resource URL
DescriptionDetailed completion report

Retry with Escalation

Section titled “Retry with Escalation”
  • Up to 3 attempts per step
  • On failure: user chooses skip / escalate / revise_plan
  • revise_plan returns to planning phase with issue context

User Approval Gates

Section titled “User Approval Gates”
  • Plan approval: Required before execution begins
  • Escalation decisions: User controls failure handling

Example Node Configuration

Section titled “Example Node Configuration”
{
  "id": "execute-step",
  "type": "agent-directive",
  "directive": "Execute step {{current_step_number}}: {{current_step_description}}. Provide evidence of completion.",
  "completionCondition": "Step executed with verifiable evidence matching expected_output",
  "connections": {
    "next": "verify-step"
  }
}

Use Cases

Section titled “Use Cases”
  • Write and publish article
  • Conduct research with report
  • Implement feature with tests
  • Prepare presentation
  • Any task with 3+ steps requiring verified completion
Section titled “Related”