do-issue

// Uses subagents for parallel execution with code review gates between batches. Use when addressing 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 dire

$ git log --oneline --stat

stars:201

forks:38

updated:March 4, 2026

SKILL.mdreadonly

SKILL.md Frontmatter

namedo-issue

descriptionUses subagents for parallel execution with code review gates between batches. Use when addressing 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.

categoryworkflow-automation

tagsgithub,gitlab,issues,subagents,parallel,automation,cross-platform

dependenciesleyline:git-platform,superpowers:subagent-driven-development,superpowers:writing-plans,superpowers:test-driven-development,superpowers:requesting-code-review,superpowers:finishing-a-development-branch

toolsgh (GitHub CLI) / glab (GitLab CLI),Task (subagent dispatch)

usage_patternsissue-discovery,task-planning,parallel-execution,quality-gates

complexityadvanced

estimated_tokens2500

modulesmodules/issue-discovery.md,modules/task-planning.md,modules/parallel-execution.md,modules/quality-gates.md,modules/completion.md,modules/troubleshooting.md

Key Features
Workflow Overview
Required TodoWrite Items
Configuration
Detailed Resources

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

do-issue:discovery-complete
do-issue:tasks-planned
do-issue:parallel-batch-complete
do-issue:review-passed
do-issue:sequential-complete
do-issue:issues-updated

Forge CLI Commands

Use the platform detected in session context (git_platform:). See Skill(leyline:git-platform) for full mapping.

Operation	GitHub (`gh`)	GitLab (`glab`)
Fetch issue	`gh issue view <N> --json title,body,labels,comments`	`glab issue view <N>`
Comment	`gh issue comment <N> --body "msg"`	`glab issue note <N> --message "msg"`
Close	`gh issue close <N> --comment "reason"`	`glab issue close <N>`
Search	`gh issue list --search "query"`	`glab issue list --search "query"`

Verification: Run the command with --help flag to verify availability.

Agent Teams (Default Execution Mode)

Agent teams is the default parallel execution backend for do-issue. Teammates coordinate via filesystem-based messaging, enabling real-time communication when shared files or dependencies are discovered mid-implementation.

Automatic downgrade: For single issues with --scope minor, agent teams is skipped (Task tool or inline execution is used instead). Use --no-agent-teams to force Task tool dispatch for any invocation.

Requires: Claude Code 2.1.32+, tmux, CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1. If prerequisites are missing, silently falls back to Task tool dispatch.

# Agent teams configuration
fix_issue:
  agent_teams:
    enabled: true           # on by default; --no-agent-teams to disable
    max_teammates: 4        # limit concurrent workers
    model: sonnet           # teammate model (lead uses current model)
    auto_downgrade: true    # skip agent teams for --scope minor

See modules/parallel-execution.md for detailed agent teams patterns.

Configuration

fix_issue:
  parallel_execution: true
  max_parallel_subagents: 3
  review_between_batches: true
  auto_close_issues: false
  commit_per_task: true