---

name: ac-task-executor description: Execute implementation tasks in autonomous coding. Use when running feature implementations, executing build tasks, processing feature queue, or orchestrating task completion.

AC Task Executor

Execute implementation tasks for autonomous coding features.

Purpose

Orchestrates the execution of feature implementations, managing the task queue and coordinating between planning, implementation, and verification phases.

Quick Start

Copyfrom scripts.task_executor import TaskExecutor

executor = TaskExecutor(project_dir)
result = await executor.execute_next_feature()

Execution Modes

Single Feature

Execute one feature at a time:

Copyresult = await executor.execute_feature("auth-001")

Queue Mode

Process feature queue continuously:

Copyawait executor.execute_queue(max_features=10)

Batch Mode

Execute multiple features in a batch:

Copyresults = await executor.execute_batch(["auth-001", "auth-002"])

Task Lifecycle

Copy1. SELECT   → Choose next feature from queue
2. PREPARE  → Load context, generate tests (RED)
3. IMPLEMENT → Write code to pass tests (GREEN)
4. REFACTOR → Clean up while tests pass
5. VALIDATE → Run criteria validation
6. COMMIT   → Git commit changes
7. UPDATE   → Mark feature as passes: true
8. NEXT     → Continue to next feature

Execution Result

Copy{
  "feature_id": "auth-001",
  "status": "completed",
  "phases": {
    "prepare": {"success": true, "duration_ms": 1500},
    "implement": {"success": true, "duration_ms": 45000},
    "validate": {"success": true, "duration_ms": 5000},
    "commit": {"success": true, "commit_hash": "abc123"}
  },
  "tests": {
    "total": 5,
    "passed": 5,
    "failed": 0
  },
  "metrics": {
    "tokens_used": 15000,
    "estimated_cost": 0.23
  }
}

Error Handling

• Validation Failure: Retry implementation up to 3 times
• Test Failure: Analyze failures, adjust approach
• Timeout: Save state, create handoff for continuation
• Critical Error: Rollback to last checkpoint

Integration

• Uses: ac-state-tracker, ac-test-generator, ac-criteria-validator
• Triggers: ac-commit-manager, ac-qa-reviewer
• Reports to: ac-session-manager

API Reference

See scripts/task_executor.py for full implementation.