Skip to content

Executes tasks from task-master with comprehensive tracking

<command_structure>
  <metadata>
    <instruction>You must complete all three stages in order and cannot skip any stage or the completion indicator.</instruction>
  </metadata>

  <preparation_stage>
    <description>Before you begin any work, you must validate that you have sufficient context and resources</description>
    <requirements>
      <requirement_list>
        <requirement>Task file path is provided and file exists</requirement>
        <requirement>Task file follows task-master format with hierarchical structure</requirement>
        <requirement>Git repository is initialized and accessible</requirement>
        <requirement>Development branch exists and is accessible</requirement>
        <requirement>Write permissions for task file and git operations</requirement>
      </requirement_list>
    </requirements>
    <critical_validation>
      <condition>If ANY requirement fails, immediately stop and respond with:</condition>
      <error_response>ERROR: Insufficient context - missing [specific requirement]. Please provide task file path and ensure git repository is accessible.</error_response>
      <instruction>Do not proceed to execution. Only continue if you can confirm you have everything needed.</instruction>
    </critical_validation>
  </preparation_stage>

  <execution_stage>
    <success_criteria>Targeted tasks completed with proper branch management, testing validation, and task file status updates</success_criteria>
    <error_handling>
      <policy>IF any step fails:</policy>
      <steps>
        <step>Log error with specific execution component that failed</step>
        <step>Attempt retry once with alternative approach</step>
        <step>If still failing, mark that task as INCOMPLETE and continue to next available task if in scope</step>
      </steps>
    </error_handling>
    <sub-agents>
      <agent>Task Parser Agent: Parse task file structure and identify target tasks</agent>
      <agent>Branch Manager Agent: Handle git branch creation, switching, and cleanup operations</agent>
      <agent>Context Analyzer Agent: Perform comprehensive project context analysis and architecture understanding</agent>
      <agent>Implementation Agent: Execute approved solutions with best practices and quality standards</agent>
      <agent>Validation Agent: Run compilation checks, testing pipelines, and quality assurance</agent>
      <agent>Progress Tracker Agent: Update task file status and manage completion tracking</agent>
    </sub-agents>
    <execution_steps>
      <instruction>Execute these steps in exact order:</instruction>
      <step_list>
        <step>Initialize specialized sub-agents for task execution workflow</step>
        <step>Present scope options to user (single sub-task, full task, complete task list)</step>
        <step>Execute main execution cycle with plan mode activation, implementation, validation, and progress tracking</step>
        <step>Handle branch management, merging, and cleanup according to completion scope</step>
        <step>Synthesize sub-agent outputs into completed task deliverables with quality validation</step>
      </step_list>
    </execution_steps>
  </execution_stage>

  <resolution_stage>
    <description>Analyze the complete execution:</description>
    <validation_areas>
      <area>Verify all targeted tasks completed successfully with proper git commits</area>
      <area>Confirm task file checkboxes accurately reflect completion status</area>
      <area>Check that all testing and compilation validation passed</area>
      <area>Validate proper branch management and cleanup occurred</area>
      <area>Ensure work scope preferences were respected and execution stopped appropriately</area>
    </validation_areas>
    <completion_indicator>
      <format>Always end with:</format>
      <template>
        FLOW COMPLETE:  execution finished - Status: [SUCCESS/PARTIAL/FAILED] - Timestamp: [completion time]
        [Summary of execution and outcomes]
      </template>
    </completion_indicator>
  </resolution_stage>
</command_structure>