GloriousFlywheel Enrollment Scoreboard Contract 2026-04-18
Snapshot date: 2026-04-18
Purpose
Define the reporting contract for orgwide enrollment so GloriousFlywheel status surfaces stop mixing together:
- real runner authority
- reusable-workflow consumption
- authority exceptions
This is the smallest note that turns the 2026-04-18 reality check into a stable scoreboard.
Why One Number Fails
One headline number hides three different truths:
- how many recent downstream repos actually run authoritative paths on GloriousFlywheel-backed runners
- how many repos merely consume shared templates
- how many repos only count if a non-default branch or non-primary repo is treated as authority
When those are collapsed, template usage and branch exceptions get mistaken for runner enrollment.
Scoreboard Rules
1. Use Default Branch As The Baseline
The normal orgwide scoreboard starts from the default branch.
That is the least gameable baseline and the best default for:
- current-state claims
- PM rollups
- issue and status updates
2. Track Authority Exceptions Separately
If a repo’s real product authority is not its default branch or not its primary non-fork repo surface, count that repo in a separate exception bucket.
Current example:
Jesssullivan/MassageIthacaondev/main
Do not silently add that repo into the default-branch denominator or numerator.
3. Template Consumption Is Not Runner Enrollment
A repo only counts toward runner enrollment if its authoritative workflow path visibly uses one of:
- an explicit shared ARC lane
- an explicit repo-owned runner contract
Template usage alone does not count.
4. Count Template Consumers By Mode
Reusable workflow consumers must be split into:
- hosted
- shared
- repo-owned
Only the last two can contribute to runner enrollment, and only when the authoritative workflow path really uses them.
5. Exclude Source And Template Repos From Downstream Adoption Claims
Use two denominators:
- workflow-surface context: all recent repos with workflows
- downstream adoption:
recent workflow repos excluding
tinyland-inc/GloriousFlywheelandtinyland-inc/ci-templates
This keeps platform self-proof and template infrastructure from inflating downstream adoption.
6. Do Not Count Raw Compatibility Lanes As Clean Enrollment
These do not count as clean runner authority unless they are the real intended contract on the authoritative path:
- literal
[self-hosted, ...]compatibility jobs - hardware-bound jobs
- one-off pet-runner lanes
- cache-only or Nix-only hosted flows
Required Weekly Scoreboard
Every orgwide status read should publish these numbers.
A. Workflow Surface Context
- recent non-fork repos
- recent repos with workflows
- recent downstream repos with workflows
- recent hosted-only workflow repos
B. Real Runner Enrollment
- recent downstream repos with shared ARC authority paths on default branch
- recent downstream repos with repo-owned authority paths on default branch
- authority exceptions with real runner authority off the primary counted surface
- downstream enrolled repos on default branch
- downstream enrolled repos with explicit branch-authority exceptions included
- broader cited-repo read with all named authority exceptions included
C. Template Consumer Modes
- hosted template consumers
- shared template consumers
- repo-owned template consumers
Current 2026-04-18 Snapshot
Workflow Surface Context
- recent non-fork repos:
88 - recent repos with workflows:
41 - recent downstream repos with workflows:
39 - recent hosted-only workflow repos on default branch:
20
Real Runner Enrollment
- shared ARC authority paths on default branch:
4tinyland-inc/blahajtinyland-inc/labtinyland-inc/tinyland.devJesssullivan/yt-text
- repo-owned authority paths on default branch:
2Jesssullivan/scheduling-kitJesssullivan/acuity-middleware
- authority exceptions with real runner authority off the primary counted
surface:
1Jesssullivan/MassageIthacaondev/main
- downstream enrolled repos on default branch:
6 / 39- about
15%
- about
- downstream enrolled repos with explicit branch-authority exceptions included:
7 / 39- about
18%
- about
Template Consumer Modes
- hosted template consumers:
6tinyland-inc/tinyvectorstinyland-inc/vite-plugin-a11ytinyland-inc/tinyland-rate-limittinyland-inc/tinyland-physicstinyland-inc/tinyland-color-utilstinyland-inc/tinyland-a11y-engine
- shared template consumers:
0proven on the scanned surface - repo-owned template consumers:
2Jesssullivan/scheduling-kitJesssullivan/acuity-middleware
PM Surface Wording
Use language like:
- downstream runner enrollment is
6 / 39on default branches, or7 / 39when including one explicit branch-authority exception - template adoption is
8repos, but only2of those are repo-owned runner consumers and6remain hosted template consumers
Do not use language like:
- “8 repos use ci-templates, so 8 repos are enrolled”
- “recent org activity is mostly on GloriousFlywheel”
- “MassageIthaca is counted cleanly in the default-branch census”
Operational Use
Use this contract in:
docs/current-state.md- weekly PM and issue rollups
- adoption notes and queue updates
- Linear or status summaries where enrollment is discussed
If a repo changes mode, update the mode bucket first, then update the runner enrollment line only if the authoritative workflow path changed too.
Exit Condition
This note can retire once:
- default-branch and authority-branch reporting converge again
- broken self-hosted activation drift is gone from the cited repo set
- template mode is explicit for all active consumers
- orgwide status surfaces already report runner authority and template mode as separate numbers by default