Execute tasks phase-by-phase from task files created by task-writing skill. Use when user requests to "execute task", "run phase", "continue task", "start phase X", or when implementing work defined in Task-XXX files. Handles phase-by-phase execution with automatic status tracking, prerequisite validation, testing after each phase, and automatic error correction. Only executes one phase at a time and stops after completion. Works with task files in _tasks/ directory.
Execute structured tasks phase-by-phase with automatic status tracking, testing, and progress reporting.
If user specifies a phase number:
If user says "continue task" or doesn't specify:
task_status_reader.py to read the task filepending (could be in-progress or completed)pending phase after thatIf user specifies a task file path:
_tasks/ directorypython scripts/task_status_reader.py _tasks/Task-XXX_Name.md
Validation checks:
[x])Safety check for in-progress phases:
in-progress, ask the user:
Before starting work, update the phase status:
python scripts/task_status_updater.py _tasks/Task-XXX_Name.md phase <phase_number> in-progress
Also update task-level status to in-progress if it's still pending:
python scripts/task_status_updater.py _tasks/Task-XXX_Name.md task in-progress
For each file listed in the phase:
As you work, progressively update the task file:
python scripts/task_status_updater.py _tasks/Task-XXX_Name.md check <phase_number> deliverables "deliverable text"
Progress reporting:
Important: Testing is ONLY required if the project has tests!
Determine which tests to run:
Test execution:
# Example: Run specific test file
npm test -- path/to/modified-feature.test.js
# Example: Run tests matching pattern
pytest tests/test_modified_feature.py
# Example: Run with coverage
dotnet test --filter FullyQualifiedName~ModifiedClass
If tests fail:
failed - always fix and retryAfter tests pass:
python scripts/task_status_updater.py _tasks/Task-XXX_Name.md check <phase_number> test_requirements "Unit tests"
If project has no tests:
Check that all items are complete:
[x][x] (if tests exist)Verification script can help:
python scripts/task_status_reader.py _tasks/Task-XXX_Name.md
Mark the phase as completed:
python scripts/task_status_updater.py _tasks/Task-XXX_Name.md phase <phase_number> completed
Check if all phases are complete:
completed:
python scripts/task_status_updater.py _tasks/Task-XXX_Name.md task completed
Provide a summary:
Example completion report:
✅ Phase 2: Business Logic Implementation - COMPLETED
Accomplished:
- Created src/services/AuthService.js with authentication logic
- Modified src/controllers/UserController.js to integrate auth
- Added validation for user credentials
Tests: All 15 tests passed ✅
Next: Phase 3 - API Integration (status: pending)
Stop execution after completion - Do NOT automatically continue to next phase.
Key principle: Only test what changed!
Error correction approach:
failedBefore starting:
During execution:
After completion:
Show progress clearly:
Regular updates keep user informed:
Parse task files and extract current status.
Usage:
python scripts/task_status_reader.py <task_file_path>
Output:
Update phase status, task status, and checkboxes.
Update phase status:
python scripts/task_status_updater.py <task_file> phase <phase_num> <status>
# Example: python scripts/task_status_updater.py _tasks/Task-001.md phase 2 in-progress
Update task status:
python scripts/task_status_updater.py <task_file> task <status>
# Example: python scripts/task_status_updater.py _tasks/Task-001.md task completed
Check individual checkbox:
python scripts/task_status_updater.py <task_file> check <phase_num> <section> <item_text>
# Example: python scripts/task_status_updater.py _tasks/Task-001.md check 2 deliverables "Create service"
Check all checkboxes in section:
python scripts/task_status_updater.py <task_file> check-all <phase_num> <section>
# Example: python scripts/task_status_updater.py _tasks/Task-001.md check-all 2 test_requirements
Sections:
prerequisitesdeliverablestest_requirementsStatus values:
pending, in-progress, completedpending, in-progress, completed# 1. Read task status
python scripts/task_status_reader.py _tasks/Task-001_Feature.md
# 2. Identify next pending phase (e.g., Phase 2)
# 3. Update to in-progress
python scripts/task_status_updater.py _tasks/Task-001_Feature.md phase 2 in-progress
# 4. Do the work...
# 5. Run relevant tests
npm test -- feature.test.js
# 6. Mark completed
python scripts/task_status_updater.py _tasks/Task-001_Feature.md phase 2 completed
# User: "Execute phase 3 of Task-001"
# 1. Read and validate
python scripts/task_status_reader.py _tasks/Task-001_Feature.md
# 2. Check if phase 3 prerequisites are met
# 3. Update status
python scripts/task_status_updater.py _tasks/Task-001_Feature.md phase 3 in-progress
# 4. Execute phase work...
# 5. Complete
python scripts/task_status_updater.py _tasks/Task-001_Feature.md phase 3 completed
# User: "Continue the task"
# 1. Read current status
python scripts/task_status_reader.py _tasks/Task-001_Feature.md
# 2. Find last non-pending phase (e.g., Phase 2 is completed)
# 3. Execute next phase (Phase 3)
python scripts/task_status_updater.py _tasks/Task-001_Feature.md phase 3 in-progress
# ... work continues
User request: "Continue Task-001"
Step 1 - Determine phase:
$ python scripts/task_status_reader.py _tasks/Task-001_UserAuth.md
Task: Task-001 - User Authentication
Status: in-progress
Phases (4):
✅ Phase 1: Foundation [completed]
✅ Phase 2: Business Logic [completed]
⏸️ Phase 3: API Integration [pending]
⏸️ Phase 4: Testing & Documentation [pending]
Next phase to execute: Phase 3 - API Integration
Step 2 - Validate and start:
$ python scripts/task_status_updater.py _tasks/Task-001_UserAuth.md phase 3 in-progress
✅ Phase 3 status updated to 'in-progress'
Step 3 - Execute work:
🔄 Starting Phase 3: API Integration
Prerequisites check:
✅ All prerequisites met
Working on deliverables:
🔄 Creating src/routes/auth.routes.js...
✅ Deliverable 1/3 completed
🔄 Modifying src/app.js to register routes...
✅ Deliverable 2/3 completed
🔄 Adding authentication middleware...
✅ Deliverable 3/3 completed
Step 4 - Test:
🧪 Running tests for modified files...
$ npm test -- auth.routes.test.js
✅ All 8 tests passed
Checking test requirements...
✅ Unit tests
✅ Integration tests
Step 5 - Complete:
$ python scripts/task_status_updater.py _tasks/Task-001_UserAuth.md phase 3 completed
✅ Phase 3 status updated to 'completed'
Step 6 - Report:
✅ Phase 3: API Integration - COMPLETED
Accomplished:
- Created authentication routes (src/routes/auth.routes.js)
- Integrated routes into main app
- Added JWT middleware for protected endpoints
Files:
- Created: 1 file
- Modified: 2 files
Tests: 8/8 passed ✅
Next: Phase 4 - Testing & Documentation (status: pending)
```38:["$","$L3f",null,{"content":"$40","frontMatter":{"name":"task-execution","description":"Execute tasks phase-by-phase from task files created by task-writing skill. Use when user requests to \"execute task\", \"run phase\", \"continue task\", \"start phase X\", or when implementing work defined in Task-XXX files. Handles phase-by-phase execution with automatic status tracking, prerequisite validation, testing after each phase, and automatic error correction. Only executes one phase at a time and stops after completion. Works with task files in _tasks/ directory."}}]