Execute Tasks

---
name: execute-tasks
description: Execute tasks from a tasks.md file using constitution-task-executor with automated constitutional code review and refinement loop
argument-hint: "path/to/tasks-file.md"
allowed-tools: Read, Task, Glob
---

Execute tasks from a tasks.md file with automated constitutional compliance enforcement and review-refine loop until approval.

## Usage

```bash
/execute-tasks path/to/tasks-file.md

Examples

/execute-tasks specs/feature-tasks.md
/execute-tasks specs/parallel-pipeline-tasks.md
/execute-tasks specs/model-by-task-tasks.md

Overview

This command implements an automated review-refine loop:

1. Execute → Run constitution-task-executor on tasks file
2. Review → Run constitution-code-reviewer on implementation
3. Decide:
   • If issues found → Generate refinement tasks (*-r{N}-tasks.md) and loop back to step 1
   • If approved → Generate approval doc (*-r{N}-approval.md) and exit

This continues until code meets all constitutional requirements.

Steps

1. Validate Input

TASKS_FILE = $1

If TASKS_FILE is empty:
  Display: "Error: Tasks file path required."
  Display: "Usage: /execute-tasks path/to/tasks-file.md"
  Exit

If TASKS_FILE doesn't exist:
  Display: "Error: Tasks file not found: $TASKS_FILE"
  Exit

If TASKS_FILE doesn't end with "-tasks.md":
  Display: "Error: File must end with '-tasks.md'"
  Display: "This command only executes tasks files generated by constitution-task-generator."
  Exit

2. Initialize Loop Variables

CURRENT_TASKS_FILE = $TASKS_FILE
ITERATION = 0
MAX_ITERATIONS = 5
APPROVED = false

3. Review-Refine Loop

Execute the following loop until approval or max iterations:

WHILE NOT APPROVED AND ITERATION < MAX_ITERATIONS:
  ITERATION = ITERATION + 1

  Display: "═══════════════════════════════════════════════════════"
  Display: "Iteration {ITERATION}: Executing tasks..."
  Display: "Task File: {CURRENT_TASKS_FILE}"
  Display: "═══════════════════════════════════════════════════════"

  # Step 3a: Execute Tasks
  Invoke constitution-task-executor with:
    Execute ALL tasks from: {CURRENT_TASKS_FILE}

    PRIMARY MANDATE: Execute ALL tasks from start to finish WITHOUT stopping.

    1. Read @.claude/constitution.md
    2. Load tasks from {CURRENT_TASKS_FILE}
    3. Execute ALL tasks sequentially (NO STOPPING, NO CONFIRMATION)
    4. Update EVERY checkbox IMMEDIATELY after completion:
       - Quick Task Checklist
       - Constitutional Compliance checks
       - Code Quality Gates
       - Success Criteria
       - All other checkboxes throughout document
    5. Apply all 7 constitutional principles:
       - I. Radical Simplicity
       - II. Fail Fast
       - III. Type Safety
       - IV. Structured Data Models
       - V. Unit Testing with Mocking
       - VI. Dependency Injection (all REQUIRED)
       - VII. SOLID Principles

    CRITICAL: Update ALL checkboxes in real-time. If can't check box, explain why.

  Display: "Task execution complete."
  Display: ""

  # Step 3b: Review Implementation
  Display: "═══════════════════════════════════════════════════════"
  Display: "Running constitutional code review..."
  Display: "═══════════════════════════════════════════════════════"

  Invoke constitution-code-reviewer with:
    Review implementation from tasks file: {CURRENT_TASKS_FILE}

    PRIMARY MANDATE: Comprehensive constitutional audit of all implemented code.

    1. Read @.claude/constitution.md
    2. Read specification file (derive from tasks file path)
    3. Read tasks file: {CURRENT_TASKS_FILE}
    4. Identify all implemented files (from completion summary)
    5. Audit EVERY file against 7 constitutional principles
    6. Verify ALL requirements implemented
    7. Validate ALL checkboxes addressed
    8. Generate output:
       - If issues found: Create {basename}-r{iteration}-tasks.md
       - If approved: Create {basename}-r{iteration}-approval.md

    Be thorough. Enforce constitution rigorously. Acknowledge documented deviations.

  Display: "Code review complete."
  Display: ""

  # Step 3c: Check Review Result

  # Derive basename from current tasks file
  # Examples:
  #   specs/feature-tasks.md → basename = "feature"
  #   specs/feature-r1-tasks.md → basename = "feature"
  #   specs/feature-r2-tasks.md → basename = "feature"

  BASENAME = extract basename from CURRENT_TASKS_FILE (remove "-tasks.md" and any "-r{N}" suffix)
  DIRECTORY = directory of CURRENT_TASKS_FILE

  APPROVAL_FILE = "{DIRECTORY}/{BASENAME}-r{ITERATION}-approval.md"
  REFINEMENT_FILE = "{DIRECTORY}/{BASENAME}-r{ITERATION}-tasks.md"

  # Check which file was created
  If APPROVAL_FILE exists:
    APPROVED = true
    Display: "═══════════════════════════════════════════════════════"
    Display: "✅ CONSTITUTIONAL APPROVAL GRANTED"
    Display: "═══════════════════════════════════════════════════════"
    Display: "Approval Document: {APPROVAL_FILE}"
    Display: "All constitutional requirements met."
    Display: "Implementation ready for deployment."
    Break loop

  Else If REFINEMENT_FILE exists:
    Display: "═══════════════════════════════════════════════════════"
    Display: "⚠️  Issues Found - Refinement Required"
    Display: "═══════════════════════════════════════════════════════"
    Display: "Refinement Tasks: {REFINEMENT_FILE}"
    Display: "Starting refinement iteration {ITERATION + 1}..."
    Display: ""

    CURRENT_TASKS_FILE = REFINEMENT_FILE
    Continue loop

  Else:
    Display: "Error: Code reviewer did not generate output file."
    Display: "Expected either:"
    Display: "  - {APPROVAL_FILE} (if approved)"
    Display: "  - {REFINEMENT_FILE} (if issues found)"
    Exit with error

END WHILE

4. Handle Loop Exit

If APPROVED:
  Display: ""
  Display: "════════════════════════════════════════════════════════════"
  Display: "                    EXECUTION COMPLETE"
  Display: "═══════════════════════════════════════════════════