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

Phase 1: See modules/issue-discovery.md for input parsing and requirement extraction
Phase 2: See modules/task-planning.md for dependency analysis
Phase 3: See modules/parallel-execution.md for subagent dispatch
Phase 4: See modules/quality-gates.md for review patterns
Phase 5-6: See modules/completion.md for finalization
Errors: See modules/troubleshooting.md for common issues

fix-issue

Installation

Details

Usage

Skill Instructions