Skip to main content

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โ€‹

  1. Resolves the backing tracker and identifies triage candidates
  2. Classifies each item across the platform's categorization dimensions
  3. Compares items across several similarity dimensions to flag duplicates
  4. Records recommendations with reasoning in a planning file
  5. 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.

AxisAzure DevOpsGitHubJira
Ownership areaArea PathLabel (area category)Component
UrgencyPriorityLabel (priority category)Priority
Defect severitySeverity (bugs only)Label (severity convention)Priority or custom field
Free taggingTagsLabel (type and lifecycle)Labels
SchedulingIteration PathMilestoneSprint

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โ€‹


๐Ÿค– Crafted with precision by โœจCopilot following brilliant human instruction, then carefully refined by our team of discerning human reviewers.