← Explore all agents

CI DIAGNOSIS / Astral Software Inc.

uv workflow-failure

Classifies one failed uv workflow as flaky or deterministic, and as create, duplicate, or ignore.

“Diagnose the failed workflow described in `.workflow-failure-event.json` and `.workflow-failure-log.txt` for the repository in this checkout.”

01 / THE REASONING

Why this made the selection.

  • flaky is allowed only when every independent root cause is transient. One deterministic failure makes the run deterministic. Dependent cancellations are not independent root causes.
  • A red pull request is not by itself a reason to open an issue. ignore is an explicit outcome. The body has to carry the run URL and the error excerpt, and the prompt forbids @mentions.

02 / THE REVIEW RECORD

What we actually inspected.

Source review has boundaries.
A clear record is more useful than a “safe” badge.

Material inspected

  • agents/prompts/diagnose-workflow-failure.md
  • agents/prompts/triage-issue.md
  • agents/codex/config.toml
  • LICENSE-MIT
  • agents/schemas/workflow-failure.json
  • .github/workflows/diagnose-workflow-failure.yml (launch configuration, selected context preparation and downstream job permissions)
  • Round 2: pinned definition, output contract and permission/dependency boundaries reread on 2026-10-14

Our findings

  • LICENSE-MIT is the MIT License. The copyright line is Copyright (c) 2025 Astral Software Inc. The prompts have no per-file copyright header.
  • decision is create, duplicate, or ignore. failure_kind is flaky or deterministic.
  • The schema requires related, decision, failure_kind, decision_reason, comment_note and issue; the issue object remains required for duplicate/ignore outcomes even though its text is empty.
  • The workflow supplies the workflow-failure profile and exact schema to the diagnosis call. Later retry and report jobs independently request write credentials.
  • Issue drafts contain one constrained label and a decisive error excerpt. The prompt requires search scope and ruled-out candidates so duplicate checking is reviewable.
  • flaky applies only when every independent root-cause failure is transient; a mixed or uncertain run must not be dismissed wholesale.
  • Duplicate issue notes are reserved for material differences in the occurrence, and drafts must avoid mentions and sensitive values.

Not established by this review

  • The agent was not executed; model behaviour, host compatibility and task outcomes were not runtime-tested.
  • No uv command, Codex invocation or GitHub workflow was run.
  • Later reporting/retry job permissions were inspected; their full implementation and credential broker were not security-audited.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

Use the role in your project.

Upstream setup instructions ↗
  1. Read the prompt at the reviewed commit. No install command is published.
  2. Do not treat the prompt as permission to post, commit, or push. The prompt text and the permission profile are separate from later workflow jobs.

Before you start

  • A checkout of astral-sh/uv at a revision the prompt can read

04 / FOLLOW THE EVIDENCE

The source trail.

Our notes are separate from the original resource.
Check upstream before adopting a new version.

  1. uv workflow-failure ↗Checked

    https://github.com/astral-sh/uv/blob/c0110fc79aea1e6e8a09feb4a72b0732fc101170/agents/prompts/diagnose-workflow-failure.md

    Supports: summary, whySelected, limitations

  2. https://github.com/astral-sh/uv/blob/c0110fc79aea1e6e8a09feb4a72b0732fc101170/agents/codex/config.toml

    Supports: permission profile

  3. MIT licence ↗Checked

    https://github.com/astral-sh/uv/blob/c0110fc79aea1e6e8a09feb4a72b0732fc101170/LICENSE-MIT

    Supports: Redistribution terms, Copyright (c) 2025 Astral Software Inc.

  4. https://github.com/astral-sh/uv/blob/c0110fc79aea1e6e8a09feb4a72b0732fc101170/agents/schemas/workflow-failure.json

    Supports: Required output keys, Allowed decisions and extra-property rejection

  5. https://github.com/astral-sh/uv/blob/c0110fc79aea1e6e8a09feb4a72b0732fc101170/.github/workflows/diagnose-workflow-failure.yml

    Supports: Prompt/schema/profile wiring, Separate downstream mutation privileges

  6. https://github.com/astral-sh/uv/blob/c0110fc79aea1e6e8a09feb4a72b0732fc101170/agents/prompts/triage-issue.md

    Supports: Search breadth, Candidate rationale

Evidence & Ask