Execute approved task specifications sequentially with TDD, comprehensive testing, and validation. This skill should be used for implementing tasks from approved specs with full audit trail.
Instrucciones de origen · Vista previa de solo lectura
name
execute-task
description
Execute approved task specifications sequentially with TDD, comprehensive testing, and validation. This skill should be used for implementing tasks from approved specs with full audit trail.
acceptance
[{"task_loaded":"Task specification successfully loaded and validated"},{"status_updated":"Task status progressed from Approved → InProgress → Review"},{"all_complete":"All tasks and subtasks marked complete"},{"tests_passing":"All tests written and passing"},{"criteria_verified":"All acceptance criteria verified and documented"},{"record_complete":"Implementation Record fully populated"}]
inputs
{"task_file":{"type":"string","required":true,"description":"Path to task specification file (e.g., .claude/tasks/task-006.md)","validation":"Must be existing file with status 'Approved'"},"auto_confirm":{"type":"boolean","required":false,"description":"Skip execution plan confirmation","default":false}}
outputs
{"implementation_complete":{"type":"boolean","description":"Whether all tasks completed successfully"},"tasks_completed":{"type":"number","description":"Number of tasks completed"},"subtasks_completed":{"type":"number","description":"Number of subtasks completed"},"tests_passed":{"type":"boolean","description":"Whether all tests passed"},"total_tests":{"type":"number","description":"Total number of tests executed"},"files_modified":{"type":"array","description":"List of files created or modified"},"status":{"type":"string","description":"Final task status (should be 'Review')"}}
Execute approved task specifications sequentially using Test-Driven Development (TDD), with comprehensive validation at each step and full implementation audit trail.
Core Capabilities:
Sequential task/subtask execution with validation gates
Permission-controlled file modifications
Comprehensive testing and documentation
Implementation Record maintenance
Halt-on-error safeguards
BMAD Pattern (Key Innovation):
ALL context embedded in task spec by planning skill
Dev reads ONLY task spec + always-load files (coding standards)
No architecture lookup during implementation
Result: Focused execution, no context searching, no drift
Prerequisites
Task specification file with status "Approved"
Configuration file (.claude/config.yaml) with development settings
Always-load files (coding standards) available
Test framework configured (Jest, Pytest, etc.)
Workflow
Step 0: Load Configuration and Task Specification
Action: Load all required context and verify task readiness.
Task status is "Approved" (halt if Draft/Review/Done)
Always-load files exist
Update Status:
Change task status from "Approved" to "InProgress"
Record start time in Implementation Record
See:references/configuration-guide.md for detailed configuration loading
Step 1: Review Task Context and Plan Execution
Action: Review embedded context and present execution plan to user.
Context Review:
Previous task insights
Data models and schemas
API specifications
Component specifications
File locations
Testing requirements
Technical constraints
Task Breakdown:
Count total tasks and subtasks
Identify current task (first unchecked)
Understand task dependencies
Present Plan: Display execution plan with task name, file, context loaded (task spec + coding standards), execution sequence (numbered tasks with subtask counts), total counts, confirmation prompt
See:references/templates.md#execution-plan-template for complete format
Wait for confirmation unless auto_confirm=true
Halt Conditions:
Context appears insufficient
Task breakdown unclear
User does not confirm
See:references/task-execution-guide.md for execution details
Step 2: Execute Current Task
Action: Execute each task and subtask sequentially with validation.
For each task in sequence:
Announce task: Display task name with acceptance criteria and subtask list
For each subtask: Implement (read context, create/modify files per coding standards) | If "Write tests": create and run tests (must pass) | If "Validate": run tests, linter, verify AC | Update checkbox to [x] only when complete | Record notes in Implementation Record (deviations, decisions, learnings)
After all subtasks: Run task validation (all tests, lint, AC coverage) | Update task checkbox [x] only when validated | Update Implementation Record (files, notes)
Move to next task
Halt Conditions:
3 consecutive implementation failures on same subtask
Ambiguous requirements discovered
Missing dependencies not documented
Regression test failures
User requests halt
See:references/task-execution-guide.md for detailed execution examples
Step 3: Final Validation and Documentation
Action: Run complete validation and finalize documentation.
Documentation: Update Implementation Record with agent model, completion notes (details, decisions, learnings), files modified (created/modified lists), testing results (unit/integration/regression test counts, coverage %, execution time)
See:references/templates.md#implementation-record-complete-template for complete format
Status Update:
Change status from "InProgress" to "Review"
DO NOT mark as "Done" (quality skill does that)
Present Summary: Display completion summary with task name, status (Review), what was implemented, all ACs met (with checkmarks), test results (counts, coverage, regression), files created/modified counts, quality review prompt
See:references/templates.md#completion-summary-template for complete format
See:references/validation-guide.md for validation details
Step 4: Handle Quality Review (Optional)
Action: Provide next steps based on user decision.
If user requests quality review: Confirm task marked "Review", provide next step (use quality review skill with task file)
If user approves without review: Confirm approval, provide next steps (commit changes, mark "Done", move to next task)
See:references/templates.md#step-4-handle-quality-review for complete messages
File Modification Permissions
CRITICAL PERMISSION BOUNDARIES:
YOU ARE AUTHORIZED TO:
✅ Update "Implementation Record" section of task file
✅ Update task/subtask checkboxes ([ ] to [x])
✅ Update task status line (Approved → InProgress → Review)
Enforcement: Only edit Implementation Record section and checkboxes/status
See:references/permissions-halts.md for detailed permission boundaries
Halt Conditions
Must halt execution and ask user when:
Consecutive Failures (default: 3)
Same subtask fails 3 times in a row
Present error and ask for guidance
Ambiguous Requirements
Context insufficient to implement subtask
Multiple valid interpretations
Critical technical decision needed
Missing Dependencies
Required library/service not documented
External API credentials needed
Database not accessible
Regression Failures
Existing tests start failing
Breaking change introduced
User Interruption
User requests halt
User asks question mid-execution
Halt Message Format: Display halt warning with reason (category), context (what was attempted), issue (specific problem), need from user (required info/decision), current progress (tasks/subtasks complete vs remaining), ready to resume condition
See:references/templates.md#halt-message-templates for all halt types
See:references/permissions-halts.md for halt handling details
See:references/templates.md#complete-json-output-format for full structure and examples (success, with halts, failed)
Error Handling
If any step fails:
1. Task File Not Found:
Error: "Task file not found"
Action: Verify file path
2. Task Status Not Approved:
Error: "Task must be Approved before execution"
Action: Check task status, update if needed
3. Test Failures:
Error: "X tests failing"
Action: Review failures, fix issues, re-run
4. Missing Dependencies:
Error: "Dependency X not found"
Action: Verify task spec includes dependency info
Best Practices
Trust the task spec (context embedded, don't search) | Sequential execution (complete current before next) | Test before checking (run tests before marking [x]) | Document as you go (update notes after each task) | Respect permissions (only Implementation Record + checkboxes) | Halt when appropriate (don't guess unclear requirements)
See:references/best-practices.md and references/templates.md#best-practices-with-examples for detailed guidance and examples
Routing Guidance
Use this skill when:
Executing an approved task specification
Need sequential, validated task execution
Want comprehensive testing and documentation
Need implementation audit trail
Always use after:
Task spec created and approved
Planning complete
Before:
Quality review
Pull request creation
Reference Files
Detailed documentation in references/:
templates.md: All output formats, examples, file templates, integration workflows, JSON structures, error templates, command-line usage, best practices with examples
configuration-guide.md: Loading config, always-load files, status management