| name | fix-issue |
| description | Fix GitHub issues using subagent-driven-development with parallel execution
where appropriate.
Triggers: fix issue, github issue, issue resolution, subagent development,
parallel execution, issue workflow, gh issue, fix github
Use when: addressing GitHub issues systematically, multiple related issues
need fixing, tasks can be parallelized across subagents, quality gates needed
between task batches
DO NOT use when: single simple fix - just implement directly.
DO NOT use when: issue needs clarification - comment first to clarify scope.
Uses subagents for parallel execution with code review gates between batches.
|
| category | workflow-automation |
| tags | github, issues, subagents, parallel, automation |
| dependencies | superpowers:subagent-driven-development, superpowers:writing-plans, superpowers:test-driven-development, superpowers:requesting-code-review, superpowers:finishing-a-development-branch |
| tools | gh (GitHub CLI), Task (subagent dispatch) |
| usage_patterns | issue-discovery, task-planning, parallel-execution, quality-gates |
| complexity | advanced |
| estimated_tokens | 2500 |
| modules | modules/issue-discovery.md, modules/task-planning.md, modules/parallel-execution.md, modules/quality-gates.md, modules/completion.md, modules/troubleshooting.md |
Fix GitHub Issue(s)
Retrieves GitHub issue content and uses subagent-driven-development to systematically address requirements, executing tasks in parallel where dependencies allow.
Key Features
- Flexible Input: Single issue number, GitHub URL, or space-delimited list
- Parallel Execution: Independent tasks run concurrently via subagents
- Quality Gates: Code review between task groups
- Fresh Context: Each subagent starts with clean context for focused work
Workflow Overview
| Phase |
Description |
Module |
| 1. Discovery |
Parse input, fetch issues, extract requirements |
issue-discovery |
| 2. Planning |
Analyze dependencies, create task breakdown |
task-planning |
| 3. Execution |
Dispatch parallel subagents for independent tasks |
parallel-execution |
| 4. Quality |
Code review gates between task batches |
quality-gates |
| 5-6. Completion |
Sequential tasks, final review, issue updates |
completion |
Required TodoWrite Items
fix-issue:discovery-complete
fix-issue:tasks-planned
fix-issue:parallel-batch-complete
fix-issue:review-passed
fix-issue:sequential-complete
fix-issue:issues-updated
GitHub CLI Commands
# Fetch issue details
gh issue view <number> --json title,body,labels,comments
# Add completion comment
gh issue comment <number> --body "message"
# Close issue
gh issue close <number> --comment "reason"
Configuration
fix_issue:
parallel_execution: true
max_parallel_subagents: 3
review_between_batches: true
auto_close_issues: false
commit_per_task: true
Detailed Resources