aspiers/ai-config / .agents/skills/task-orchestration
task-orchestration
VerifiedRuns the full implement-and-commit loop over a task list — selects the next incomplete sub-task, implements it, runs linters and tests, marks it done, commits, and repeats until the list is finished. Use when asked to work through a feature's task list at .ai/[feature]/tasks.md unattended, or to keep going until every sub-task is complete. For a single sub-task with no commit, use task-implementation; to stop for approval between each one, use iterative-development.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.2 KB |
SKILL.md
View on GitHub---
name: task-orchestration
description: >-
Runs the full implement-and-commit loop over a task list — selects the next
incomplete sub-task, implements it, runs linters and tests, marks it done,
commits, and repeats until the list is finished. Use when asked to work
through a feature's task list at .ai/[feature]/tasks.md unattended, or to
keep going until every sub-task is complete. For a single sub-task with no
commit, use task-implementation; to stop for approval between each one, use
iterative-development.
---
# Task Orchestration
Orchestrate the complete development workflow for implementing sub-tasks from a task list.
## When to Use This Skill
Use this skill when:
- You need to implement a specific sub-task from a task list
- You want to follow a structured development workflow with quality controls
- Working on features with existing task lists in `.ai/[feature_name]/tasks.md`
- You need to ensure code quality through linting and testing before committing
Don't use this skill:
- When there are no existing task lists
- For ad-hoc code changes without structured task management
- When you need to work on multiple tasks simultaneously
## What This Agent Does
1. **Task Selection**: Identifies and selects the appropriate sub-task from a task list
2. **Implementation**: Uses the task-implementer skill to implement the selected sub-task
3. **Quality Control**: Runs code linters and tests to ensure code quality
4. **Task Management**: Updates task completion status in the task list
5. **Version Control**: Stages and commits changes following proper git workflow
6. **Iterative Process**: Continues with the next incomplete sub-task until all are done
## Task Selection Process
### Command Arguments
- `feature_name` - Locates the relevant task list at `.ai/[feature_name]/tasks.md`
- `subtask_number` - The specific sub-task number to implement
### Selection Logic
1. If `feature_name` is not provided:
- List all available task lists in `.ai/*/tasks.md`
- Show feature names as a numbered list
- Ask user to pick one to work on (excluding completed ones)
2. If `subtask_number` is not provided:
- Show all unimplemented sub-tasks
- Identify the first incomplete sub-task
- Ask user if they want to implement that one, or select another
## Sub-task Completion Protocol
**CRITICAL: Follow this exact sequence. NO EXCEPTIONS!**
1. **Implement**: Use the task-implementer skill to implement the selected sub-task
2. **Lint**: Use the code-linter skill to run all appropriate linters according to repository guidelines
3. **Test**: Use the test-runner skill to run all appropriate tests according to repository guidelines
4. **Fix Issues**: If linting or testing fails, attempt to fix the issues. Do NOT proceed until both pass
5. **Mark Complete**: Update the task list by changing `[ ]` to `[x]` for the completed sub-task. If all sub-tasks under a parent task are complete, also mark the parent task as complete
6. **Stage Changes**: Use the git-stager skill to stage relevant changes, ensuring to include the updated `tasks.md` file
7. **User Review**: Ask the user to review changes and approve with "good" or "vibe". If user responds with "vibe", skip this step for future iterations in the session
8. **Commit**: ONLY after user approval, use the git-committer skill to commit with a proper message
9. **Continue**: Select the next incomplete sub-task and repeat from step 1
## Quality Gates
- **Linting**: All linters must pass before proceeding
- **Testing**: All tests must pass before proceeding
- **User Approval**: Changes must be reviewed and approved before committing
- **Task Tracking**: Task completion must be properly recorded
## Error Handling
- If linting fails: Attempt to auto-fix, then ask user if manual fixes are needed
- If testing fails: Attempt to fix issues, then ask user for guidance
- If user rejects changes: Ask for specific feedback and iterate
- If no more tasks: Inform user that all tasks are complete
## Integration with Other Skills
This orchestrator works closely with:
- `task-implementation` - For actual code implementation
- `code-linting` - For code quality checks
- `test-running` - For test execution
- `git-staging` - For staging changes
- `git-commit` - For creating commits
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |