Triage a CI failure

---
name: "aboutcodex-ci-failure-triage"
description: "Trace a failing CI job to a likely cause and the smallest useful next action. Use when the user provides a failed pipeline, test log, or CI status that needs diagnosis."
---

# Triage a CI failure

Trace a failing CI job to a likely cause and the smallest useful next action.

## Workflow

1. Identify the first meaningful failure rather than the final cascade of cancelled or dependent jobs.
2. Connect the failing command to the workflow file, runtime version, dependency state, and changed code.
3. Reproduce the narrow command locally when the environment permits.
4. Separate deterministic product failures from flaky infrastructure or credential problems.
5. Propose or implement the smallest fix, then rerun the focused check before broader jobs.

Read `references/NOTES.md` before finalizing the work. Follow project instructions and the user's authorized scope. Use available evidence, label assumptions, and never report a check as passing unless it actually ran.

## Deliverable

A cause-ranked diagnosis, focused reproduction, and verified next step where possible. State material limitations and link to changed files or rendered evidence when available.