Skip to content

Commit 86ea49f

Browse files
chore(scorecard-reusable): align example with canonical weekly schedule + document drift (#230)
## Summary Estate audit (2026-05-28) found **180 repos running scorecard daily** at 04:00 UTC (`'0 4 * * *'`) vs **29 on the canonical weekly schedule** (`'23 4 * * 1'`). The actual canonical caller at `hyperpolymath/standards/.github/workflows/scorecard.yml` has always been weekly — the drift was driven by the example block in this reusable's header still documenting daily. This PR is the **upstream first cut** of the GH Actions budget rebalancing plan (2026-05-27): - Fixes the example to match the canonical weekly schedule - Adds an explicit note explaining the convention so future deployments inherit weekly rather than re-introducing daily ## Budget impact (existing drift) 180 daily × (365 − 52) ≈ 56k extra runs/year × ~1.5 min/run ≈ **~84k Actions-minutes/year** on scorecard alone. This PR alone changes 1 line of cron in a doc-comment + adds an explanatory block. The actual estate fan-out (converting the 180 daily-scheduled repos to weekly) is tracked separately as cut 2. ## Test plan - [x] No behavioural change to the reusable workflow (only comments + example modified) - [x] Canonical caller `.github/workflows/scorecard.yml` already uses `'23 4 * * 1'`; this PR aligns the docs 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent 68715a7 commit 86ea49f

1 file changed

Lines changed: 18 additions & 1 deletion

File tree

.github/workflows/scorecard-reusable.yml

Lines changed: 18 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@
3636
# push:
3737
# branches: [main, master]
3838
# schedule:
39-
# - cron: '0 4 * * *'
39+
# - cron: '23 4 * * 1' # Weekly (Monday 04:23 UTC) — match canonical
4040
# workflow_dispatch:
4141
# concurrency:
4242
# group: ${{ github.workflow }}-${{ github.ref }}
@@ -49,6 +49,23 @@
4949
# security-events: write
5050
# id-token: write
5151
# uses: hyperpolymath/standards/.github/workflows/scorecard-reusable.yml@<sha>
52+
#
53+
# CANONICAL SCHEDULE — WEEKLY, NOT DAILY (2026-05-28).
54+
# Estate audit found 180 repos running daily at 04:00 UTC ('0 4 * * *')
55+
# vs 29 on canonical weekly ('23 4 * * 1') — drift driven by an older
56+
# version of the example above. The actual canonical caller in
57+
# `hyperpolymath/standards/.github/workflows/scorecard.yml` has always
58+
# been weekly. The example now matches.
59+
#
60+
# GH Actions budget impact of the drift: 180 daily × (365 − 52) ≈ 56k
61+
# extra runs/year × ~1.5 min/run ≈ ~84k Actions-minutes/year. Fan-out
62+
# to convert the 180 estate repos from daily→weekly is tracked
63+
# separately (GH-Actions budget rebalancing 2026-05-27).
64+
#
65+
# When to deviate: a repo with a very high merge/push cadence AND
66+
# scorecard-sensitive supply-chain churn (heavy dependency refresh)
67+
# MAY opt into more frequent runs. Daily is rarely worth it; the
68+
# scorecard signal moves on the order of weeks, not hours.
5269

5370
name: Scorecard (reusable)
5471

0 commit comments

Comments
 (0)