zeroclaw/.github/workflows
Alex Gorevski 44725da08c perf(ci): reduce GitHub Actions costs ~60-65% across all workflows
Analysis of Feb 17 data showed 400+ workflow runs/day consuming ~398 billable minutes (~200 hours/month projected). Implemented targeted optimizations:

High-impact changes:

- sec-audit.yml: add path filters (Cargo.toml, src/**, crates/**, deny.toml); skip docs-only PRs

- test-benchmarks.yml: move from every-push-to-main to weekly schedule; retention 30d -> 7d

- pub-docker-img.yml: tighten PR smoke build path filters to Docker-specific files only

- sec-codeql.yml: reduce from twice-daily (14 runs/week) to weekly

Medium-impact changes:

- ci-run.yml: merge lint + lint-strict-delta into single job; drop --release from smoke build

- feature-matrix.yml: remove push trigger (weekly-only); remove redundant cargo test step

- dependabot.yml: monthly instead of weekly; reduce PR limits from 11 to 5/month; group all deps

Runner cost savings:

- Switch 6 lightweight API-only workflows to ubuntu-latest (PR Labeler, Intake, Auto Responder, Check Stale, Check Status, Sync Contributors)

- pr-check-status.yml: reduce from every 12h to daily

New files:

- docs/ci-cost-optimization.md: comprehensive analysis and revised architecture documentation

- scripts/ci/fetch_actions_data.py: reusable GitHub Actions cost analysis script

Estimated impact: daily billable minutes ~400 -> ~120-150 (60-65%% reduction), monthly hours ~200 -> ~60-75, Dependabot PRs ~44/month -> ~5 (89%% reduction)
2026-02-18 21:14:47 -08:00
..
scripts fix(workflow): align first-interaction input keys (#821) 2026-02-18 22:24:51 +08:00
ci-run.yml perf(ci): reduce GitHub Actions costs ~60-65% across all workflows 2026-02-18 21:14:47 -08:00
feature-matrix.yml perf(ci): reduce GitHub Actions costs ~60-65% across all workflows 2026-02-18 21:14:47 -08:00
main-branch-flow.md fix(docker): unblock workspace build and auto-publish latest image 2026-02-18 17:14:46 +08:00
pr-auto-response.yml perf(ci): reduce GitHub Actions costs ~60-65% across all workflows 2026-02-18 21:14:47 -08:00
pr-check-stale.yml perf(ci): reduce GitHub Actions costs ~60-65% across all workflows 2026-02-18 21:14:47 -08:00
pr-check-status.yml perf(ci): reduce GitHub Actions costs ~60-65% across all workflows 2026-02-18 21:14:47 -08:00
pr-intake-checks.yml perf(ci): reduce GitHub Actions costs ~60-65% across all workflows 2026-02-18 21:14:47 -08:00
pr-label-policy-check.yml chore(ci): align workflow names with file naming style (#723) 2026-02-17 19:55:05 -05:00
pr-labeler.yml perf(ci): reduce GitHub Actions costs ~60-65% across all workflows 2026-02-18 21:14:47 -08:00
pub-docker-img.yml perf(ci): reduce GitHub Actions costs ~60-65% across all workflows 2026-02-18 21:14:47 -08:00
pub-release.yml chore(ci): align workflow names with file naming style (#723) 2026-02-17 19:55:05 -05:00
README.md chore(ci): externalize workflow scripts and relocate main flow doc (#722) 2026-02-17 19:48:37 -05:00
sec-audit.yml perf(ci): reduce GitHub Actions costs ~60-65% across all workflows 2026-02-18 21:14:47 -08:00
sec-codeql.yml perf(ci): reduce GitHub Actions costs ~60-65% across all workflows 2026-02-18 21:14:47 -08:00
sync-contributors.yml perf(ci): reduce GitHub Actions costs ~60-65% across all workflows 2026-02-18 21:14:47 -08:00
test-benchmarks.yml perf(ci): reduce GitHub Actions costs ~60-65% across all workflows 2026-02-18 21:14:47 -08:00
test-e2e.yml chore(ci): align workflow names with file naming style (#723) 2026-02-17 19:55:05 -05:00
test-fuzz.yml chore(ci): align workflow names with file naming style (#723) 2026-02-17 19:55:05 -05:00
test-rust-build.yml chore(ci): align workflow names with file naming style (#723) 2026-02-17 19:55:05 -05:00
workflow-sanity.yml ci(workflows): split label policy checks from workflow sanity (#559) 2026-02-17 11:26:54 -05:00

Workflow Directory Layout

GitHub Actions only loads workflow entry files from:

  • .github/workflows/*.yml
  • .github/workflows/*.yaml

Subdirectories are not valid locations for workflow entry files.

Repository convention:

  1. Keep runnable workflow entry files at .github/workflows/ root.
  2. Keep workflow-only helper scripts under .github/workflows/scripts/.
  3. Keep cross-tooling/local CI scripts under scripts/ci/ when they are used outside Actions.

Workflow behavior documentation in this directory:

  • .github/workflows/main-branch-flow.md

Current workflow helper scripts:

  • .github/workflows/scripts/ci_workflow_owner_approval.js
  • .github/workflows/scripts/lint_feedback.js
  • .github/workflows/scripts/pr_auto_response_contributor_tier.js
  • .github/workflows/scripts/pr_auto_response_labeled_routes.js
  • .github/workflows/scripts/pr_check_status_nudge.js
  • .github/workflows/scripts/pr_intake_checks.js
  • .github/workflows/scripts/pr_labeler.js
  • .github/workflows/scripts/test_benchmarks_pr_comment.js