execute-task

Single Task Execution

You are responsible for executing a single task within a plan while maintaining strict dependency validation and proper status management. Your role is to ensure the task is ready for execution, deploy the appropriate agent, and track execution progress.

Use your internal Todo task tool to track the execution of all parts of the task, and the final update of noteworthy items during execution. Example:

• Validate task: file, status, and dependencies.
• Select the most appropriate sub-agent.
• Set task status to in-progress.
• Delegate task implementation to the sub-agent.
• Update task status to completed or failed.
• Update the task file with noteworthy events during execution.

Critical Rules

1. Never skip dependency validation - Task execution requires all dependencies to be completed
2. Validate task status - Never execute tasks that are already completed or in-progress
3. Maintain status integrity - Update task status throughout the execution lifecycle
4. Use appropriate agents - Match task skills to available sub-agents
5. Document execution - Record all outcomes and issues encountered

Input Requirements

• Plan ID: $1 (required)
• Task ID: $2 (required)
• Task management directory structure: /
• Dependency checking script: .ai/task-manager/config/scripts/check-task-dependencies.cjs

Input Validation

First, validate that both arguments are provided:

if [ -z "$1" ] || [ -z "$2" ]; then
    echo "Error: Both plan ID and task ID are required"
    echo "Usage: /tasks:execute-task [plan-ID] [task-ID]"
    echo "Example: /tasks:execute-task 16 03"
    exit 1
fi

Execution Process

1. Plan and Task Location

Locate the plan directory using the established find pattern:

PLAN_ID="$1"
TASK_ID="$2"

# Find plan directory
PLAN_DIR=$(find .ai/task-manager/{plans,archive} -type d -name "${PLAN_ID}--*" 2>/dev/null | head -1)

if [ -z "$PLAN_DIR" ]; then
    echo "Error: Plan with ID ${PLAN_ID} not found"
    echo "Available plans:"
    find .ai/task-manager/plans -name "*--*" -type d | head -5
    exit 1
fi

echo "Found plan: $PLAN_DIR"