insomnia.club back to site
[ playbook · engineering ]

Bug triage with AI: from vague report to reproducible ticket

Bug reports arrive from support, customers, and internal testers in every possible format. An agent turns each one into a structured ticket: deduplicated, matched to real errors and logs, reproduced where possible, and assigned to the team that owns the code, with a severity a person confirms.

who owns it

Engineering manager or on-call lead who runs the bug queue

what starts it

A bug is filed in the tracker, escalated from support, or raised by an error alert

01the problem and who owns it

"Checkout is broken" is not a bug report. Engineers lose hours asking which browser, which account, which step, and whether this is the same thing someone reported last Tuesday. Meanwhile, the duplicates pile up and the queue looks three times worse than it is.

The engineering manager owns triage, usually in a weekly meeting that is mostly reading. Severity gets set by whoever shouts loudest, and genuinely urgent bugs that arrive with a polite, vague description sit untouched.

02what the AI does, step by step

  1. Normalize the reportThe agent extracts what is known from the free text, screenshots, and support thread: affected feature, platform, account, time, steps, and expected versus actual behavior. Missing fields become specific questions sent back to the reporter.
  2. Find duplicates and siblingsUsing embeddings over open and recently closed tickets, the agent links likely duplicates and proposes merging them, keeping every reporter attached so all of them hear about the fix.
  3. Pull the evidenceFor the reported time and account, it searches error tracking and logs for matching exceptions, failed requests, and recent deploys touching the area. Stack traces and the suspect release go onto the ticket.
  4. Attempt a reproductionIn a staging environment with seeded test data, the agent follows the reported steps with a browser automation tool or API calls and records the result. A failing reproduction becomes a draft regression test.
  5. Propose owner and severityOwnership comes from CODEOWNERS and the service catalog. Severity is proposed against your written rubric: data loss, payments, security, number of affected accounts, and workaround available.
  6. Hand off a ready ticketThe ticket reaches the owning team's queue with evidence, reproduction status, and open questions. Severity one candidates page on-call immediately rather than waiting for the weekly meeting.

03systems it connects to

04human checkpoints

05what to measure

06risks and guardrails

07build vs buy

Error tracking tools already group exceptions and suggest owners, and support desks can auto-tag tickets. If most of your bugs surface as exceptions, those features may be enough.

Custom work pays off when reports start as messy human descriptions, when evidence is spread across several tools, or when reproducing a bug needs your staging data and test accounts.

Browse every engineering playbook or the full library.

want this running in your business?

We can connect your tracker, error tracking, and staging environment, agree a severity rubric with your team, and run triage on your live bug queue alongside the weekly meeting.

See how we deliver it: ai coding orchestration.

book a call drop your number

info@insomnia.club