---
name: ci-failure-triage
description: Diagnose a failing CI/CD run from logs and repository evidence, then propose and verify the smallest fix.
---

1. Read repository instructions and inspect the exact failing run, job, step and annotation.
2. Separate environment, permissions, dependency, test, build and deployment failures.
3. Reproduce the failing check locally when safe; do not guess from the final status alone.
4. State the leading hypothesis and cite the log evidence that supports it.
5. Make the smallest source or workflow change that addresses the cause.
6. Run the affected checks and adjacent fast checks.
7. Review the diff, preserve unrelated work and report residual deployment risk.