# Bug Triage

Re-evaluate open bugs, priority vs severity, assign to sprints, surface systemic trends.

- Repository: https://github.com/Donchitos/Claude-Code-Game-Studios (32144 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-10-19
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add Donchitos/Claude-Code-Game-Studios --skill bug-triage -g -a claude-code -y`
Codex: `npx skills add Donchitos/Claude-Code-Game-Studios --skill bug-triage -g -a codex -y`
Cursor: `npx skills add Donchitos/Claude-Code-Game-Studios --skill bug-triage -g -a cursor -y`
Gemini CLI: `npx skills add Donchitos/Claude-Code-Game-Studios --skill bug-triage -g -a gemini-cli -y`

## Description

Re-evaluate open bugs, priority vs severity, assign to sprints, surface systemic trends. Run when the count grows.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

!`bash "${CLAUDE_SKILL_DIR}/../../hooks/yaml-helper.sh" resolve_config --keys automation,workflow`

**Automation mode**: Resolve `modes.automation` (`project.local.yaml` →
`project.yaml` → default `collaborative`). Every `AskUserQuestion` call and
every file write follows `.claude/docs/automation-modes.md`
(collaborative asks always · guided major-only · autonomous logs and proceeds;
`automation_always_ask` categories always prompt).

# Bug Triage

This skill processes the open bug backlog into a prioritised, sprint-assigned
action list. It distinguishes between **severity** (how bad is the impact?) and
**priority** (how urgently must we fix it?), detects systemic trends, and
ensures no critical bug is lost between sprints.

**Output:** `production/qa/bug-triage-[date].md`

**When to run:**
- Sprint start, assign open bugs to the new sprint or backlog
- After `/team-qa` completes and new bugs have been filed
- When the bug count crosses 10+ open items

---

## 1. Parse Arguments

**Modes:**
- `/bug-triage sprint`, triage against the current sprint; assign fixable bugs
  to the sprint backlog; defer the rest
- `/bug-triage full`, full triage of all bugs regardless of sprint scope
- `/bug-triage trend`, trend analysis only (no assignment); read-only report
- No argument, run sprint mode if a current sprint exists, else full mode

---

## 2. Load Bug Backlog

### Step 2a, Discover bug files

Glob for bug reports in priority order:
1. `production/qa/bugs/*.md`, individual bug report files (preferred format)
2. `production/qa/bugs.md`, single consolidated bug log (fallback)
3. Any `production/qa/qa-plan-*.md` "Bugs Found" table (last resort)

If no bug files found:
> "No bug files found in `production/qa/bugs/`. If bugs are tracked in a
> different location, adjust the glob pattern. If no bugs exist yet, there is
> nothing to triage."

The rest: https://github.com/Donchitos/Claude-Code-Game-Studios/blob/HEAD/.claude/skills/bug-triage/SKILL.md