--- 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`) # 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](modules/issue-discovery.md) | | 2. Planning | Analyze dependencies, create task breakdown | [task-planning](modules/task-planning.md) | | 3. Execution | Dispatch parallel subagents for independent tasks | [parallel-execution](modules/parallel-execution.md) | | 4. Quality | Code review gates between task batches | [quality-gates](modules/quality-gates.md) | | 5-6. Completion | Sequential tasks, final review, issue updates | [completion](modules/completion.md) | ## Required Progress Items 1. `do-issue:discovery-complete` 2. `do-issue:tasks-planned` 3. `do-issue:parallel-batch-complete` 4. `do-issue:review-passed` 5. `do-issue:sequential-complete` 6. `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 --json title,body,labels,comments` | `glab issue view ` | | Comment | `gh issue comment --body "msg"` | `glab issue note --message "msg"` | | Close | `gh issue close --comment "reason"` | `glab issue close ` | | 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. ```yaml # 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 ```yaml fix_issue: parallel_execution: true max_parallel_subagents: 3 review_between_batches: true auto_close_issues: false commit_per_task: true ``` **Verification:** Run the command with `--help` flag to verify availability. ## Detailed Resources - **Phase 1**: See [modules/issue-discovery.md](modules/issue-discovery.md) for input parsing and requirement extraction - **Phase 2**: See [modules/task-planning.md](modules/task-planning.md) for dependency analysis - **Phase 3**: See [modules/parallel-execution.md](modules/parallel-execution.md) for subagent dispatch - **Phase 4**: See [modules/quality-gates.md](modules/quality-gates.md) for review patterns - **Phase 5-6**: See [modules/completion.md](modules/completion.md) for finalization - **Errors**: See [modules/troubleshooting.md](modules/troubleshooting.md) for common issues ## Exit Criteria - [ ] All 6 required progress items (`do-issue:discovery-complete` through `do-issue:issues-updated`) are created before execution starts and each marked complete when its phase finishes - [ ] Issue requirements fetched using the correct forge CLI (`gh` for GitHub, `glab` for GitLab) as detected in session context - [ ] Exactly one consolidated PR is opened covering all issues; no per-issue PRs are created - [ ] Code review gate runs between parallel task batches and must pass before the next batch is dispatched - [ ] All specified issues are commented on or closed with a reference to the PR after it is ready for review --- Source attribution: athola Original project: https://github.com/athola/claude-night-market/blob/a1624efd2f3d149d479cbad0d81328cf6a402a03/plugins/sanctum/skills/do-issue/SKILL.md License: MIT License information: https://opensource.org/license/mit Original upstream instructions; downloaded from Dave AI. ## Upstream license notice MIT License Copyright (c) 2025 athola Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. # Dave AI resource metadata Creator / publisher: athola Original project: https://github.com/athola/claude-night-market/blob/a1624efd2f3d149d479cbad0d81328cf6a402a03/plugins/sanctum/skills/do-issue/SKILL.md Attribution basis: Recovered original package and original project license at a pinned revision Fields of work: Marketing, Sales Roles: Growth Marketer, Sales Engineer, Sales Development Rep (SDR) Specialties: API Tools: GitHub Country applicability: Country not specified Classification basis: Source catalog labels Instruction SHA-256: 1f92c9ececee3fef017a3a3a9f02c2a5c8eae73cd8bfc79c821026330395dbde Metadata reviewed: 2026-10-27 This metadata supersedes earlier Dave AI catalog attribution. Original instruction and supporting files are preserved.