ENGINEERING

Agent Triage of a Quarantined Test with Root-Cause Notes

When a test is newly quarantined, an agent pulls recent failure logs from Datadog and the test source from GitHub, drafts a likely-root-cause analysis.

CategoryEngineering
Enginepaperclip
Difficultyadvanced
Triggerevent
Steps6
Setup~25 min

How it runs

The automated pipeline, trigger to output.

  • TriggerLinear issue labeled flaky-quarantine webhookLinearLinear
  • ActionFetch failure traces from Datadog CI VisibilityDatadogDatadog
  • ActionRead test source and git blame from GitHubGitHubGitHub
  • LogicAgent reasons over evidence to draft root-cause hypothesis
  • ActionPost analysis and set deadline on Linear issueLinearLinear
  • OutputNotify owner in Slack that triage is readySlack

What it does

Adds an investigative layer on top of quarantine. Whenever a test gets quarantined, an agent gathers the evidence and produces a first-pass root-cause hypothesis so the owner opens the ticket already pointed at the likely culprit.

When to use it

Use this when quarantine tickets land on owners with no context and the fix stalls because nobody has time to dig. The agent does the initial digging and frees the owner to validate rather than start cold.

How it works

  1. 1A webhook fires when a Linear issue is labeled 'flaky-quarantine'.
  2. 2The agent fetches recent failure traces and error patterns for that test from Datadog CI Visibility.
  3. 3It reads the test file and recent git blame on it from GitHub to spot timing, ordering, or shared-state risks.
  4. 4The agent reasons over the evidence and drafts a root-cause hypothesis with concrete next steps and suspect lines.
  5. 5It posts the analysis as a comment on the Linear issue and sets a re-enable deadline based on assessed difficulty.
  6. 6The owner is notified in Slack that triage notes are ready.

Set it up

What you configure once, before turning it on.

  1. 1
    Connect LinearIssues, projects, cycles, triage.
  2. 2
    Connect DatadogMetrics, traces, log search.
  3. 3
    Connect GitHubRepos, issues, pull requests, actions.
  4. 4
    Connect SlackChannels, DMs, threads, mentions.
  5. 5
    Set each agent's modelWe leave models unset so you pick the tier — fast + cheap, or top-quality.
  6. 6
    Tune it to your dataEdit the prompts, filters, and field mappings so it matches how your team works.
  7. 7
    Test, then turn it onRun once against a sample, confirm the output, then enable the trigger.

Run this workflow in your colony.

14-day trial. No DevOps. No Sales call. Provisioned in under a minute.