QA GitHub Issues Enhanced
Purpose
Provide enhanced GitHub Issues workflows for QA automation. Extends qa-bug-ticket-creator and qa-task-creator with auto-labeling, issue templates, milestone management, search/deduplication, bulk operations, and structured QA lifecycle workflows—all via GitHub MCP.
Primary Target
GitHub via GitHub MCP. All operations (create, search, label, milestone, bulk) use GitHub MCP APIs.
Features
Auto-Labeling
Automatically assign labels based on:
| Signal |
Labels Applied |
| Bug report |
type/bug, priority/*, component/* |
| Test coverage gap |
test-coverage-gap, component/*, status/needs-triage |
| Flaky test |
flaky-test, component/*, status/needs-triage |
| Documentation update |
docs-update, component/* |
| Enhancement request |
type/enhancement, component/* |
See references/label-taxonomy.md for full taxonomy and color codes.
Issue Templates
Predefined templates for consistent structure:
| Template |
Use Case |
| Bug report |
Defects from test failures or manual findings |
| Test coverage gap |
Gaps from qa-coverage-analyzer or spec-auditor |
| Flaky test |
Intermittent failures from qa-flaky-detector |
| Documentation update |
Spec drift, outdated docs from qa-spec-auditor |
| Enhancement request |
Feature requests, improvements |
See references/issue-templates.md for YAML definitions.
Milestone Management
- Create milestones per sprint/release (e.g.,
Sprint 24, v2.1.0)
- Assign issues to milestones when creating or updating
- Query issues by milestone for status reports
Structured Workflows
| Workflow |
Pattern |
| Bug lifecycle |
bug-report → linked-PR → verification-test |
| Coverage gap |
gap → task → PR → coverage-verified |
| Flaky test |
flaky → investigation → fix → re-run |
See references/workflow-patterns.md for detailed patterns.
Search and Deduplication
Before creating new issues:
- Search by title keywords, component, error message, labels
- Compare similarity (same failure, component, root cause)
- Link or create — Link to duplicate or create new when no match
Bulk Operations
Batch-create issues from:
- qa-coverage-analyzer — One issue per coverage gap
- qa-spec-auditor — One issue per spec drift finding
- qa-flaky-detector — One issue per flaky test
- qa-changelog-analyzer — One issue per recommended test
Label Taxonomy
| Prefix |
Purpose |
Examples |
type/ |
Issue type |
bug, enhancement, task |
priority/ |
Urgency |
critical, high, medium, low |
component/ |
Affected area |
frontend, backend, api, auth |
status/ |
Workflow state |
needs-triage, in-progress, ready-for-test, verified |
| (no prefix) |
Special QA |
test-coverage-gap, flaky-test, docs-update |
Full taxonomy in references/label-taxonomy.md.
Integrations
| Integration |
Use |
| GitHub MCP |
All create, search, label, milestone, bulk operations |
| qa-bug-ticket-creator |
Consume bug reports; apply enhanced labels/templates |
| qa-task-creator |
Create linked tasks; apply workflow labels |
| qa-coverage-analyzer |
Bulk-create coverage gap issues |
| qa-spec-auditor |
Bulk-create spec drift issues |
| qa-flaky-detector |
Bulk-create flaky test issues |
Trigger Phrases
- "Create GitHub issues with auto-labels for [bugs / coverage gaps / flaky tests]"
- "Apply issue template for [bug / coverage gap / flaky test / docs / enhancement]"
- "Create milestone for Sprint 24 / v2.1.0"
- "Assign issues to milestone [name]"
- "Search for similar issues before creating"
- "Bulk-create issues from coverage analyzer output"
- "Bulk-create issues from spec-auditor findings"
- "Set up structured workflow for bug #123"
Workflow
- Input — Bug report, coverage gap, flaky test, spec finding, or bulk CSV/JSON
- Template — Select issue template (bug, coverage-gap, flaky, docs, enhancement)
- Labels — Auto-assign per taxonomy (type, priority, component, status)
- Deduplication — Search for similar open issues; link or create
- Milestone — Assign to sprint/release when provided
- Create — Create GitHub Issue via GitHub MCP
- Optional — Create linked task, PR reference, or verification issue
Scope
Can do (autonomous):
- Create issues with auto-labels per taxonomy
- Apply issue templates (bug, coverage-gap, flaky, docs, enhancement)
- Create and assign milestones
- Search for similar issues before creating
- Bulk-create issues from coverage/spec/flaky output
- Link issues (bug → task, task → PR)
- Update labels and milestone on existing issues
Cannot do (requires confirmation):
- Create issues in repos without write access
- Override user-specified labels or priority
- Assign assignees without configured mapping
- Create milestones without user approval
Will not do (out of scope):
- Modify production or test code
- Close or merge issues (stakeholder responsibility)
- Create issues in Jira/Linear/Azure DevOps (use references for adapters)
Quality Checklist
Troubleshooting
| Symptom |
Likely Cause |
Fix |
| GitHub MCP create fails |
Token missing, no repo access |
Check GITHUB_PERSONAL_ACCESS_TOKEN; verify repo permissions |
| Labels not applied |
Label doesn't exist in repo |
Create labels via GitHub MCP or repo settings; see label-taxonomy |
| Duplicate not detected |
Search query too narrow |
Broaden keywords; search by component + error snippet |
| Milestone not found |
Milestone not created |
Create milestone first; verify exact name |
| Bulk create partial fail |
Rate limit or invalid data |
Check GitHub API rate limits; validate input format |
| Wrong template applied |
Misclassification of input |
Ask user to confirm template; use explicit template param |
Reference Files
| Topic |
File |
| Label taxonomy with colors |
references/label-taxonomy.md |
| Issue template YAML |
references/issue-templates.md |
| Workflow patterns |
references/workflow-patterns.md |
1---2name: qa-github-issues-enhanced3description: Enhanced GitHub Issues workflows with auto-labels, issue templates, milestone management, and structured QA workflows via GitHub MCP.4---56# QA GitHub Issues Enhanced78## Purpose910Provide enhanced GitHub Issues workflows for QA automation. Extends qa-bug-ticket-creator and qa-task-creator with auto-labeling, issue templates, milestone management, search/deduplication, bulk operations, and structured QA lifecycle workflows—all via GitHub MCP.1112## Primary Target1314**GitHub** via GitHub MCP. All operations (create, search, label, milestone, bulk) use GitHub MCP APIs.1516## Features1718### Auto-Labeling1920Automatically assign labels based on:2122| Signal | Labels Applied |23| ------ | -------------- |24| Bug report | `type/bug`, `priority/*`, `component/*` |25| Test coverage gap | `test-coverage-gap`, `component/*`, `status/needs-triage` |26| Flaky test | `flaky-test`, `component/*`, `status/needs-triage` |27| Documentation update | `docs-update`, `component/*` |28| Enhancement request | `type/enhancement`, `component/*` |2930See `references/label-taxonomy.md` for full taxonomy and color codes.3132### Issue Templates3334Predefined templates for consistent structure:3536| Template | Use Case |37| -------- | -------- |38| Bug report | Defects from test failures or manual findings |39| Test coverage gap | Gaps from qa-coverage-analyzer or spec-auditor |40| Flaky test | Intermittent failures from qa-flaky-detector |41| Documentation update | Spec drift, outdated docs from qa-spec-auditor |42| Enhancement request | Feature requests, improvements |4344See `references/issue-templates.md` for YAML definitions.4546### Milestone Management4748- **Create** milestones per sprint/release (e.g., `Sprint 24`, `v2.1.0`)49- **Assign** issues to milestones when creating or updating50- **Query** issues by milestone for status reports5152### Structured Workflows5354| Workflow | Pattern |55| -------- | ------- |56| Bug lifecycle | bug-report → linked-PR → verification-test |57| Coverage gap | gap → task → PR → coverage-verified |58| Flaky test | flaky → investigation → fix → re-run |5960See `references/workflow-patterns.md` for detailed patterns.6162### Search and Deduplication6364Before creating new issues:65661. **Search** by title keywords, component, error message, labels672. **Compare** similarity (same failure, component, root cause)683. **Link or create** — Link to duplicate or create new when no match6970### Bulk Operations7172Batch-create issues from:7374- **qa-coverage-analyzer** — One issue per coverage gap75- **qa-spec-auditor** — One issue per spec drift finding76- **qa-flaky-detector** — One issue per flaky test77- **qa-changelog-analyzer** — One issue per recommended test7879## Label Taxonomy8081| Prefix | Purpose | Examples |82| ------ | ------- | -------- |83| `type/` | Issue type | `bug`, `enhancement`, `task` |84| `priority/` | Urgency | `critical`, `high`, `medium`, `low` |85| `component/` | Affected area | `frontend`, `backend`, `api`, `auth` |86| `status/` | Workflow state | `needs-triage`, `in-progress`, `ready-for-test`, `verified` |87| (no prefix) | Special QA | `test-coverage-gap`, `flaky-test`, `docs-update` |8889Full taxonomy in `references/label-taxonomy.md`.9091## Integrations9293| Integration | Use |94| ----------- | --- |95| **GitHub MCP** | All create, search, label, milestone, bulk operations |96| **qa-bug-ticket-creator** | Consume bug reports; apply enhanced labels/templates |97| **qa-task-creator** | Create linked tasks; apply workflow labels |98| **qa-coverage-analyzer** | Bulk-create coverage gap issues |99| **qa-spec-auditor** | Bulk-create spec drift issues |100| **qa-flaky-detector** | Bulk-create flaky test issues |101102## Trigger Phrases103104- "Create GitHub issues with auto-labels for [bugs / coverage gaps / flaky tests]"105- "Apply issue template for [bug / coverage gap / flaky test / docs / enhancement]"106- "Create milestone for Sprint 24 / v2.1.0"107- "Assign issues to milestone [name]"108- "Search for similar issues before creating"109- "Bulk-create issues from coverage analyzer output"110- "Bulk-create issues from spec-auditor findings"111- "Set up structured workflow for bug #123"112113## Workflow1141151. **Input** — Bug report, coverage gap, flaky test, spec finding, or bulk CSV/JSON1162. **Template** — Select issue template (bug, coverage-gap, flaky, docs, enhancement)1173. **Labels** — Auto-assign per taxonomy (type, priority, component, status)1184. **Deduplication** — Search for similar open issues; link or create1195. **Milestone** — Assign to sprint/release when provided1206. **Create** — Create GitHub Issue via GitHub MCP1217. **Optional** — Create linked task, PR reference, or verification issue122123## Scope124125**Can do (autonomous):**126- Create issues with auto-labels per taxonomy127- Apply issue templates (bug, coverage-gap, flaky, docs, enhancement)128- Create and assign milestones129- Search for similar issues before creating130- Bulk-create issues from coverage/spec/flaky output131- Link issues (bug → task, task → PR)132- Update labels and milestone on existing issues133134**Cannot do (requires confirmation):**135- Create issues in repos without write access136- Override user-specified labels or priority137- Assign assignees without configured mapping138- Create milestones without user approval139140**Will not do (out of scope):**141- Modify production or test code142- Close or merge issues (stakeholder responsibility)143- Create issues in Jira/Linear/Azure DevOps (use references for adapters)144145## Quality Checklist146147- [ ] Labels follow taxonomy (type/, priority/, component/, status/)148- [ ] Issue template applied when creating149- [ ] Deduplication search performed before creating150- [ ] Milestone assigned when user provides sprint/release151- [ ] Bulk operations include source reference (file, analyzer output)152- [ ] No hardcoded secrets; repo/org from user input or env153- [ ] Linked issues reference each other correctly154155## Troubleshooting156157| Symptom | Likely Cause | Fix |158| ------- | ------------ | --- |159| GitHub MCP create fails | Token missing, no repo access | Check `GITHUB_PERSONAL_ACCESS_TOKEN`; verify repo permissions |160| Labels not applied | Label doesn't exist in repo | Create labels via GitHub MCP or repo settings; see label-taxonomy |161| Duplicate not detected | Search query too narrow | Broaden keywords; search by component + error snippet |162| Milestone not found | Milestone not created | Create milestone first; verify exact name |163| Bulk create partial fail | Rate limit or invalid data | Check GitHub API rate limits; validate input format |164| Wrong template applied | Misclassification of input | Ask user to confirm template; use explicit template param |165166## Reference Files167168| Topic | File |169| ----- | ---- |170| Label taxonomy with colors | `references/label-taxonomy.md` |171| Issue template YAML | `references/issue-templates.md` |172| Workflow patterns | `references/workflow-patterns.md` |
azanir