name	ci-failure-triage
description	Use when `make ci-local` fails or a GitHub Actions run reports a CI failure.

CI Failure Triage

Follow AGENTS.md first.

Run make ci-local locally and identify which sub-target failed (format-check, lint-ci, typecheck-fast, or test-fast).
For format failures: run make format and re-check.
For lint failures: run make lint-fix and address remaining manual issues.
For typecheck failures: read the mypy error, fix the type annotation — do not silence with blanket # type: ignore. Use # type: ignore[specific-code] only for legitimate library typing gaps.
For test failures: read the assertion, fix the code or test (not the assertion to mask the bug). For scraper tests, consider refreshing tests/fixtures/ only if scraper logic intentionally changed.
Re-run make ci-local until green.

name	ci-failure-triage
description	Use when `make ci-local` fails or a GitHub Actions run reports a CI failure.

Follow AGENTS.md first.

Run make ci-local locally and identify which sub-target failed (format-check, lint-ci, typecheck-fast, or test-fast).
For format failures: run make format and re-check.
For lint failures: run make lint-fix and address remaining manual issues.
For typecheck failures: read the mypy error, fix the type annotation — do not silence with blanket # type: ignore. Use # type: ignore[specific-code] only for legitimate library typing gaps.
For test failures: read the assertion, fix the code or test (not the assertion to mask the bug). For scraper tests, consider refreshing tests/fixtures/ only if scraper logic intentionally changed.
Re-run make ci-local until green.

ci-failure-triage