qa-triage

Classifies and routes bugs, missing requirements, and regressions found during QA testing.

Updated Apr 13, 2026
One-click install
npx skills add https://github.com/scoots31/engineering-playbook --skill qa-triage-scoots31
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qa-triage
Source: https://github.com/scoots31/engineering-playbook/tree/main/skills/qa-triage
Command: npx skills add https://github.com/scoots31/engineering-playbook --skill qa-triage-scoots31

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When testing surfaces something unexpected, teams often guess at the fix and either patch the wrong thing or stall the entire build. This Skill classifies each discovery as a bug, missing requirement, or regression, determines its scope, and routes it to the correct response without derailing work in flight. ## Core Features & Use Cases - Three-way classification: Distinguishes bugs (spec exists, code doesn't follow it), missing requirements (behavior never defined), and regressions (previously Done work now broken) before any action is taken. - Scope-based routing: Routes each finding by blast radius — current slice, Done slice, unbuilt slice, adjacent slices, or flow-level — with a specific action table for each combination, including targeted-fix versus full-rebuild assessment for reopened slices. - Decision logging: Records every triage outcome in docs/backlog.md with type, scope, classification rationale, and action taken so future sessions don't relitigate past decisions. - Use Case: During QA sign-off, a user notices an empty state with no defined behavior. The Skill classifies it as a missing requirement, scopes it to the current slice, defines the behavior, adds it to the done criteria, and logs the decision — all without pausing the build. ## Quick Start Ask the assistant to triage an unexpected finding from testing, describing what was found and where it appeared, so it can classify the issue and route it to the right fix path.

Frequently Asked Questions about qa-triage

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I triage bugs found during QA testing?

Classify the finding first as a bug, missing requirement, or regression, then determine its scope. Bugs in the current slice return to In Build with a specific note; bugs in Done slices reopen that slice and re-run the full QA chain after the fix.

What is the difference between a bug and a missing requirement in QA?

A bug means the behavior is defined but the implementation doesn't match the spec. A missing requirement means the behavior was never defined or agreed on, so it is a specification gap rather than a code defect and needs definition, not a code fix.

How should regressions in previously completed work be handled?

Reopen the affected slice with a root-cause note identifying what changed to break it, then re-run the full QA chain. For multiple affected slices, fix the shared root cause first rather than patching each slice individually.

When should a QA finding trigger a design review instead of a fix?

Flow-level bugs and missing requirements spanning multiple slices or an entire screen trigger design review. These indicate something was misunderstood at the design stage and cannot be resolved correctly inside a QA session.

Why document triage decisions in a backlog log?

Logging each triage decision with its type, scope, and rationale prevents future sessions from relitigating past choices. Undocumented decisions lose context, and a decision made today can affect slices built several sessions later.