bmad-os-gh-triage
GitHub Issue Triage with AI Analysis
CRITICAL RULES:
- NEVER include time or effort estimates in output or recommendations
- Focus on WHAT needs to be done, not HOW LONG it takes
- Use Bash tool with gh CLI for all GitHub operations
Execution
Step 1: Fetch Issues
Use gh issue list --json number,title,body,labels to fetch all open issues.
Step 2: Batch Creation
Split issues into batches of ~10 issues each for parallel analysis.
Step 3: Parallel Agent Analysis
For EACH batch, use the Task tool with subagent_type=general-purpose to launch an agent with prompt from agent-prompt.md
Step 4: Consolidate & Generate Report
After all agents complete, create a comprehensive markdown report saved to _bmad-output/triage-reports/triage-YYYY-MM-DD.md
Report Format
Executive Summary
- Total issues analyzed
- Issue count by priority (CRITICAL, HIGH, MEDIUM, LOW)
- Major themes discovered
- Top 5 critical issues requiring immediate attention
Critical Issues (CRITICAL Priority)
For each CRITICAL issue:
- #123 - Issue Title
- What it's about: [Deep understanding]
- Affected: [Components]
- Why Critical: [Rationale]
- Suggested Action: [Specific action]
High Priority Issues (HIGH Priority)
Same format as Critical, grouped by theme.
Theme Clusters
For each major theme:
- Theme Name (N issues)
- What connects these: [Pattern]
- Root cause: [If identifiable]
- Consolidated actions: [Bulk actions if applicable]
- Issues: #123, #456, #789
Relationships & Dependencies
- Duplicates: List pairs with
gh issue closecommands - Related Issues: Groups of related issues
- Dependencies: Blocking relationships
Cross-Repo Issues
Issues that should be migrated to other repositories.
For each, provide:
gh issue close XXX --repo CURRENT_REPO --comment "This issue belongs in REPO. Please report at https://github.com/TARGET_REPO/issues/new"
Cleanup Candidates
- v4-related: Deprecated version issues with close commands
- Stale: No activity >30 days
- Low priority + old: Low priority issues >60 days old
Actionable Next Steps
Specific, prioritized actions:
- [CRITICAL] Fix broken installer - affects all new users
- [HIGH] Resolve Windows path escaping issues
- [HIGH] Address workflow integration bugs etc.
Include gh commands where applicable for bulk actions.
More from bmad-code-org/bmad-utility-skills
bmad-os-diataxis
Create, update, fix, or refine documentation using Diataxis framework and BMad Method style guide. Use when user asks to 'create a doc', 'update docs', 'fix docs style', 'refine docs', or 'improve docs writing'.
1bmad-os-review-pr
Dual-layer PR review tool (Raven's Verdict). Runs adversarial cynical review and edge case hunter in parallel, merges and deduplicates findings into professional engineering output. Use when user asks to 'review a PR' and provides a PR url or id.
1bmad-os-draft-changelog
Analyzes changes since last release and updates CHANGELOG.md ONLY. Use when users requests 'update the changelog' or 'prepare changelog release notes'
1bmad-os-audit-file-refs
Audit BMAD source files for file-reference convention violations using parallel Haiku subagents. Use when users requests an "audit file references" for a skill, workflow or task.
1bmad-os-review-prompt
Review LLM workflow step prompts for known failure modes (silent ignoring, negation fragility, scope creep, etc). Use when user asks to "review a prompt" or "audit a workflow step".
1bmad-os-findings-triage
Orchestrate HITL triage of review findings using parallel agents. Use when the user says 'triage these findings' or 'run findings triage' or has a batch of review findings to process.
1