Task Orchestration Skill
This skill automatically activates when working with task lists and implementation. It enforces documentation-first development, systematic execution, and quality assurance.
Core Principles
Documentation-First Enforcement
NO CODING WITHOUT DOCUMENTATION REVIEW
The FIRST sub-task for any coding task MUST be documentation review:
-
Review relevant API/framework documentation
-
Share key findings before implementation
-
Identify best practices and anti-patterns
-
Reference documentation in implementation
Sequential Execution Protocol
-
One task at a time - Only one task in_progress
-
Complete all sub-tasks before moving to parent
-
User confirmation required - Wait for "yes" or "y" before next task
-
Immediate file updates - Update markdown checkboxes immediately
Automatic Behaviors
- Initialize Task Tracking
-
Read task list file completely
-
Use TodoWrite to track all tasks
-
Identify dependencies between tasks
-
Verify required resources
- Execute Tasks Systematically
1.0 Parent Task 1.1 [FIRST] Documentation Review ← MANDATORY 1.2 Implementation step 1.3 Testing step 2.0 Next Parent Task ...
- Update Progress Mechanically
After EACH task completion:
-
Update TodoWrite status to "completed"
-
Change [ ] to [x] in markdown file
-
Update "Relevant Files" section
-
Report completion status
- Communicate Progress
📚 Starting task 1.1: Review documentation
- Reviewing [framework] best practices
- Key findings: ...
🚀 Starting task 1.2: Implementation
- Following patterns from docs
- Creating files...
✅ Completed task 1.2
- File created: path/to/file.js
- Tests passing
📋 Next: 1.3 Add tests Proceed? (y/n)
Quality Assurance Checklist
Before marking any task complete:
Documentation Compliance
-
Documentation was reviewed FIRST
-
Implementation follows documented patterns
-
API/framework patterns correctly applied
Code Quality
-
Follows project conventions
-
No linting errors
-
Proper error handling
-
Comments where necessary
Testing
-
Unit tests written and passing
-
Manual testing completed
-
Edge cases considered
Error Handling Protocol
When encountering issues:
⚠️ Issue encountered in task 1.2:
- Problem: [description]
- Proposed solution: [approach]
- Estimated impact: [time/scope]
Proceed with solution? (y/n)
New Task Discovery
When new tasks are discovered during implementation:
📌 New task discovered:
- Task 1.4: [description]
- Reason: [why this is needed]
- Priority: [high/medium/low]
Add to current sprint? (y/n)
-
Add to task list with [NEW] tag
-
Update TodoWrite
-
Get user confirmation