Inspect failed jobs and extract the first actionable error. Use GitHub Actions logs when available; otherwise use the check link to identify the failing command or service.
Apply the smallest safe fix.
Push, re-check the PR check set, and repeat until green.
Guardrails
Fix one actionable failure at a time.
Prefer minimal, low-risk changes before broader refactors.