| name | do-issue |
| role | entrypoint |
| description | Implements GitHub or GitLab issues via parallel subagents with review gates between task batches. Use when resolving multi-step issues end-to-end. |
| alwaysApply | false |
| category | workflow-automation |
| tags | ["github","gitlab","issues","subagents","parallel","automation","cross-platform"] |
| dependencies | ["leyline:git-platform","superpowers:subagent-driven-development","superpowers:writing-plans","superpowers:test-driven-development","superpowers:requesting-code-review","superpowers:finishing-a-development-branch"] |
| tools | [] |
| usage_patterns | ["issue-discovery","task-planning","parallel-execution","quality-gates"] |
| complexity | advanced |
| model_hint | deep |
| 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"] |
When NOT To Use
- A single-file fix obvious enough to make directly
- Preparing the PR once the work is done (use
sanctum:pr-prep)
Table of Contents
Fix Issue(s)
Retrieves issue content from the detected git platform (GitHub, GitLab, or Bitbucket) and uses subagent-driven-development to systematically address requirements, executing tasks in parallel where dependencies allow.
Platform detection is automatic via the leyline:git-platform SessionStart hook. Check session context for git_platform: to determine which CLI to use.
Key Features
- Cross-Platform: Automatically detects GitHub/GitLab/Bitbucket and uses appropriate CLI
- Flexible Input: Single issue number, platform URL, or space-delimited list
- Parallel Execution: Independent tasks run concurrently via subagents
- One PR: All issues produce one consolidated PR (never per-issue PRs)
- 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