In this article
Triage Workflow
The Triage workflow classifies existing items and recommends field, label, priority, and status changes. It is read-only: triage produces recommendations, and applying them is backlog-execute's job.
Run it with /backlog-plan triage.
When to Useโ
- ๐ฅ A backlog has accumulated unclassified items
- ๐ Duplicate reports are suspected
- ๐ Field consistency matters for reporting or filtering
- ๐งน Preparing a backlog before sprint planning
What It Doesโ
- Resolves the backing tracker and identifies triage candidates
- Classifies each item across the platform's categorization dimensions
- Compares items across several similarity dimensions to flag duplicates
- Records recommendations with reasoning in a planning file
- Produces a handoff file for review before anything is applied
NOTE
Triage recommends rather than applies. A classification you disagree with costs a line edit in the handoff file, not a tracker correction.
Classification Dimensionsโ
Every platform classifies along the same conceptual axes. The field names differ.
| Axis | Azure DevOps | GitHub | Jira |
|---|---|---|---|
| Ownership area | Area Path | Label (area category) | Component |
| Urgency | Priority | Label (priority category) | Priority |
| Defect severity | Severity (bugs only) | Label (severity convention) | Priority or custom field |
| Free tagging | Tags | Label (type and lifecycle) | Labels |
| Scheduling | Iteration Path | Milestone | Sprint |
NOTE
GitHub expresses most axes through a single label namespace, so its taxonomy carries the weight that separate fields carry elsewhere. Triage applies the repository's existing label conventions rather than imposing a fixed set.
Duplicate Detectionโ
Duplicate candidates are assessed across multiple similarity dimensions rather than a title match alone: title overlap, description overlap, component or area agreement, and reporter and timeframe proximity. An item is flagged when enough dimensions agree, and the reasoning is recorded so you can judge the call.
Ambiguous duplicates are always gated for human decision regardless of autonomy tier. Closing a real report as a duplicate is expensive to reverse.
Trigger Criteriaโ
Triage candidates are identified from classification state rather than requiring a manual list: items missing categorization, items in an initial state past a staleness threshold, and items whose type and content disagree.
Output Artifactsโ
<tracking-root>/triage/<scope-name>/
โโโ planning-log.md # Candidates, classification reasoning, phase tracking, and the plan path
โโโ triage-plan.md # Reviewed recommendations, including duplicate candidates and their similarity classification
Duplicate evidence lives in triage-plan.md rather than a separate file, and that same plan is the execution input: backlog-execute run <triage-plan.md> applies the recommendations in a separate pass. Triage itself issues no mutating call.
Next Stepsโ
- Sprint Planning: Organize triaged work into an iteration
- Execution: Apply the reviewed triage handoff
- Using Workflows Together: End-to-end pipeline walkthrough
๐ค Crafted with precision by โจCopilot following brilliant human instruction, then carefully refined by our team of discerning human reviewers.