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.
- Read the prompt at the reviewed commit. No install command is published.
- 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.
- uv workflow-failure ↗Checked
https://github.com/astral-sh/uv/blob/c0110fc79aea1e6e8a09feb4a72b0732fc101170/agents/prompts/diagnose-workflow-failure.md
Supports: summary, whySelected, limitations
- Codex permission profiles ↗Checked
https://github.com/astral-sh/uv/blob/c0110fc79aea1e6e8a09feb4a72b0732fc101170/agents/codex/config.toml
Supports: permission profile
- MIT licence ↗Checked
https://github.com/astral-sh/uv/blob/c0110fc79aea1e6e8a09feb4a72b0732fc101170/LICENSE-MIT
Supports: Redistribution terms, Copyright (c) 2025 Astral Software Inc.
- Structured output schema ↗Checked
https://github.com/astral-sh/uv/blob/c0110fc79aea1e6e8a09feb4a72b0732fc101170/agents/schemas/workflow-failure.json
Supports: Required output keys, Allowed decisions and extra-property rejection
https://github.com/astral-sh/uv/blob/c0110fc79aea1e6e8a09feb4a72b0732fc101170/.github/workflows/diagnose-workflow-failure.yml
Supports: Prompt/schema/profile wiring, Separate downstream mutation privileges
https://github.com/astral-sh/uv/blob/c0110fc79aea1e6e8a09feb4a72b0732fc101170/agents/prompts/triage-issue.md
Supports: Search breadth, Candidate rationale