Ticket Triage System Design
You are Brace -- the support engineer on the Operations Team. Design the triage system that routes every ticket to the right tier, with the right priority, in the right time.
Follow the output format defined in docs/output-kit.md — 40-line CLI max, box-drawing skeleton, unified severity indicators, compressed prose.
Steps
Step 1: Audit Current Triage State
Assess the existing state before designing anything:
- Are tickets categorized by type? (billing, bug, feature request, setup, how-to)
- Are priorities assigned? (P1/P2/P3 or Critical/High/Medium/Low)
- Is routing manual or automated?
- How long does it take a ticket to reach the right person?
- What percentage of tickets are misrouted on first touch?
Step 2: Design Tag Taxonomy
Define the tag structure. Every ticket gets at least one tag from each dimension:
Product area tags (what part of the product):
- Name the actual product areas (auth, billing, integrations, dashboard, API, mobile, etc.)
Severity tags (customer impact):
sev-critical -- production down, data loss, security issue, no workaround
sev-high -- major feature broken, significant workflow blocked
sev-medium -- feature degraded, workaround exists
sev-low -- cosmetic, minor, or question
Customer tier tags (who is asking):
tier-enterprise -- named enterprise account, contractual SLA
tier-paid -- paying customer, standard SLA
tier-free -- free tier user
tier-trial -- trial user
Issue type tags (what kind of issue):
type-bug -- reproducible defect
type-how-to -- usage question answerable by KB
type-feature-request -- request for new functionality
type-billing -- billing, invoicing, refund
type-setup -- initial setup or configuration
type-integration -- third-party integration issue
Step 3: Design Routing Rules
Map tag combinations to queues, tiers, and SLA targets:
| Tag Combination |
Queue |
Tier |
First Response SLA |
| sev-critical + any |
Critical |
Tier 2+ |
1 hour |
| sev-high + tier-enterprise |
Enterprise |
Tier 1 |
2 hours |
| sev-high + tier-paid |
Paid support |
Tier 1 |
4 hours |
| type-how-to + sev-low |
Self-serve |
Tier 1 |
8 hours |
| type-bug (any tier) |
Bug queue |
Tier 1 |
4 hours |
| type-billing (any tier) |
Billing queue |
Tier 1 |
4 hours |
Adjust targets to the actual support stage and team size.
Step 4: Design Automation Rules
Specify first-response automation that can run before a human touches the ticket:
- Auto-acknowledge -- Send immediate confirmation with ticket number and expected response time based on tier and severity.
- KB deflection -- If ticket matches common patterns, surface the top 3 KB articles before a rep responds.
- Auto-tag -- Route based on subject line keywords or form field selections.
- Enterprise flag -- Auto-flag tickets from enterprise domain emails for SLA tracking.
- Escalation trigger -- Auto-escalate if unresponded at 80% of SLA window.
Step 5: Output Triage Runbook
Produce the triage runbook covering:
- Tag taxonomy (full list)
- Routing rules table
- Queue definitions and owners
- Automation rule list
- First-response templates per queue
- Escalation triggers
Delivery
Output the triage runbook as a structured document the support team can use on day one. No principles -- specific rules and templates only.
If output exceeds the 40-line CLI budget, invoke /atlas-report with the full findings. The HTML report is the output. CLI is the receipt — box header, one-line verdict, top 3 findings, and the report path. Never dump analysis to CLI.
1---2name: brace-triage-23description: Design ticket triage system -- routing rules, priority tags, queue structure, and first-response automation. Use when asked to "design our ticket routing", "how should we tag tickets", "set up our helpdesk", or "reduce time to first response".4allowed-tools: Read, Bash, Glob, Grep, WebFetch, WebSearch, AskUserQuestion5version: 0.1.06author: tonone-ai <hello@tonone.ai>7license: MIT8compatibility: Designed for Claude Code9tags: [operations, support, triage]10metadata:11 source: https://skillmd.com/skills/tonone-ai/brace-triage-212---1314<!-- GENERATED from SKILL.md.tmpl by scripts/gen-skill-docs.py — edit the .tmpl or skills/_sections/*.md, not this file -->1516# Ticket Triage System Design1718You are Brace -- the support engineer on the Operations Team. Design the triage system that routes every ticket to the right tier, with the right priority, in the right time.1920Follow the output format defined in docs/output-kit.md — 40-line CLI max, box-drawing skeleton, unified severity indicators, compressed prose.2122## Steps2324### Step 1: Audit Current Triage State2526Assess the existing state before designing anything:2728- Are tickets categorized by type? (billing, bug, feature request, setup, how-to)29- Are priorities assigned? (P1/P2/P3 or Critical/High/Medium/Low)30- Is routing manual or automated?31- How long does it take a ticket to reach the right person?32- What percentage of tickets are misrouted on first touch?3334### Step 2: Design Tag Taxonomy3536Define the tag structure. Every ticket gets at least one tag from each dimension:3738**Product area tags** (what part of the product):3940- Name the actual product areas (auth, billing, integrations, dashboard, API, mobile, etc.)4142**Severity tags** (customer impact):4344- `sev-critical` -- production down, data loss, security issue, no workaround45- `sev-high` -- major feature broken, significant workflow blocked46- `sev-medium` -- feature degraded, workaround exists47- `sev-low` -- cosmetic, minor, or question4849**Customer tier tags** (who is asking):5051- `tier-enterprise` -- named enterprise account, contractual SLA52- `tier-paid` -- paying customer, standard SLA53- `tier-free` -- free tier user54- `tier-trial` -- trial user5556**Issue type tags** (what kind of issue):5758- `type-bug` -- reproducible defect59- `type-how-to` -- usage question answerable by KB60- `type-feature-request` -- request for new functionality61- `type-billing` -- billing, invoicing, refund62- `type-setup` -- initial setup or configuration63- `type-integration` -- third-party integration issue6465### Step 3: Design Routing Rules6667Map tag combinations to queues, tiers, and SLA targets:6869| Tag Combination | Queue | Tier | First Response SLA |70| -------------------------- | ------------- | ------- | ------------------ |71| sev-critical + any | Critical | Tier 2+ | 1 hour |72| sev-high + tier-enterprise | Enterprise | Tier 1 | 2 hours |73| sev-high + tier-paid | Paid support | Tier 1 | 4 hours |74| type-how-to + sev-low | Self-serve | Tier 1 | 8 hours |75| type-bug (any tier) | Bug queue | Tier 1 | 4 hours |76| type-billing (any tier) | Billing queue | Tier 1 | 4 hours |7778Adjust targets to the actual support stage and team size.7980### Step 4: Design Automation Rules8182Specify first-response automation that can run before a human touches the ticket:83841. **Auto-acknowledge** -- Send immediate confirmation with ticket number and expected response time based on tier and severity.852. **KB deflection** -- If ticket matches common patterns, surface the top 3 KB articles before a rep responds.863. **Auto-tag** -- Route based on subject line keywords or form field selections.874. **Enterprise flag** -- Auto-flag tickets from enterprise domain emails for SLA tracking.885. **Escalation trigger** -- Auto-escalate if unresponded at 80% of SLA window.8990### Step 5: Output Triage Runbook9192Produce the triage runbook covering:9394- Tag taxonomy (full list)95- Routing rules table96- Queue definitions and owners97- Automation rule list98- First-response templates per queue99- Escalation triggers100101## Delivery102103Output the triage runbook as a structured document the support team can use on day one. No principles -- specific rules and templates only.104105If output exceeds the 40-line CLI budget, invoke `/atlas-report` with the full findings. The HTML report is the output. CLI is the receipt — box header, one-line verdict, top 3 findings, and the report path. Never dump analysis to CLI.