Research Notes

This directory is the internal planning and evidence surface for GloriousFlywheel.

Use the public docs first:

• Current State
• Roadmap
• RFCs

Use docs/research/ when you need deeper execution detail, supporting evidence, or the reasoning behind a current boundary.

Canonical Active Notes

These are the smallest set of research notes that currently define the active internal planning surface:

• gloriousflywheel-program-surface-2026-04-15.md central internal PM and issue surface
• gloriousflywheel-cleanup-structure-2026-04-17.md structured cleanup workstreams, merge order, and exit criteria
• gloriousflywheel-adoption-homogeneity-and-dogfood-plan-2026-04-17.md honest program for adoption, contract homogeneity, dogfood, and scaling
• gloriousflywheel-active-owned-repo-adoption-board-2026-04-17.md active repo board for dogfood blockers, consumers, and adjacent surfaces
• gloriousflywheel-wave0-wave1-classification-matrix-2026-04-17.md working matrix for Wave 0 and Wave 1 repo truthing
• gloriousflywheel-exception-register-and-promotion-rules-2026-04-17.md explicit definition of runner dogfood, cache-only adoption, and repo promotion rules
• gloriousflywheel-tier-scorecard-and-template-remediation-2026-04-17.md active-set tier scorecard, shared-template debt, and first promotion packages
• gloriousflywheel-contract-remediation-packages-2026-04-17.md exact workflow surfaces, package sequencing, and first implementation pilots
• gloriousflywheel-source-default-branch-proof-package-2026-04-17.md PR-shaped source-repo self-dogfood package for a default-branch proof path
• gloriousflywheel-js-bazel-package-v2-rollout-2026-04-17.md PR-shaped V2 template contract and downstream pilot rollout plan
• gloriousflywheel-contract-rollout-pr-stack-2026-04-17.md merge-order plan, dependency stack, and verification gates for the rollout
• gloriousflywheel-js-bazel-package-v2-contract-spec-2026-04-17.md explicit V2 interface semantics for the shared JS and Bazel package workflow
• gloriousflywheel-rollout-gates-and-failure-modes-2026-04-17.md go/no-go rules, failure modes, and evidence gates for the rollout stack
• gloriousflywheel-hosted-exception-policy-2026-04-17.md policy for durable hosted exceptions, bounded hosted authority, and claim-breaking drift
• gloriousflywheel-orgwide-enrollment-reality-check-2026-04-18.md live orgwide workflow-enrollment reality check across tinyland-inc and Jesssullivan
• gloriousflywheel-orgwide-enrollment-queue-2026-04-18.md execution queue for claim protection, template cleanup, migration candidates, and hosted-by-policy repos
• gloriousflywheel-enrollment-scoreboard-contract-2026-04-18.md reporting contract for separating real runner authority, template modes, and branch-authority exceptions
• gloriousflywheel-massageithaca-branch-authority-decision-2026-04-18.md branch-authority decision note for counting MassageIthaca runner adoption accurately
• gloriousflywheel-tinyland-dev-claim-classification-2026-04-18.md classification note for treating tinyland.dev as a cache-first hybrid rather than a converged runner repo
• gloriousflywheel-template-consumer-mode-decision-2026-04-18.md mode decision for hosted, shared, and repo-owned template consumers after the V2 rollout
• gloriousflywheel-npm-publish-family-hosted-archive-policy-2026-04-18.md live classification of the archived npm-publish.yml package family as hosted template consumers outside the active migration queue
• gloriousflywheel-ci-templates-capability-matrix-2026-04-18.md live reusable-workflow matrix showing that js-bazel-package.yml is runner-flexible and npm-publish.yml is hosted-only
• gloriousflywheel-queue-c-migration-candidate-truthing-2026-04-18.md live classification of betterkvm, tinyclaw, and remote-juggler from current workflow files
• gloriousflywheel-xoxdwm-and-yt-text-claim-classification-2026-04-18.md authority and hybrid classification for the two remaining Queue A claim-protection repos
• gloriousflywheel-xoxdwm-authority-convergence-plan-2026-04-18.md concrete repair plan for removing XoxdWM from broken self-hosted activation status
• gloriousflywheel-yt-text-hybrid-exception-plan-2026-04-18.md concrete hosted-exception plan for the remaining non-authority escapes in yt-text
• gloriousflywheel-post-209-pr-slice-map-2026-04-16.md current local-worktree slice map
• gloriousflywheel-backend-target-state-2026-04-16.md backend-authority and rollout target state
• gloriousflywheel-honey-onprem-rollout-2026-04-16.md on-prem honey rollout truth
• gloriousflywheel-builder-runtime-sprint-priorities-2026-04-16.md live builder-runtime execution priorities
• gloriousflywheel-clean-derivation-promotion-workflow-2026-04-15.md acceleration versus publication boundary
• gloriousflywheel-downstream-adoption-and-migration-kit-2026-04-16.md downstream adoption lane and canary execution

Supporting Note Groups

Use these groups when you need deeper context beyond the canonical notes.

Dashboard And Operator Plane

• gloriousflywheel-dashboard-*
• gloriousflywheel-tailnet-operator-identity-2026-04-16.md

Backend And Deployment Authority

• gloriousflywheel-deployment-authority-*
• gloriousflywheel-backend-authority-options-2026-04-15.md
• gloriousflywheel-arc-ci-input-contract-2026-04-15.md
• gloriousflywheel-arc-additive-policy-governance-2026-04-15.md

Builder, Cache, And Publication

• gloriousflywheel-cache-publication-contract-2026-04-15.md
• gloriousflywheel-linux-builder-contract-2026-04-15.md
• gloriousflywheel-nix-builder-bootstrap-and-scaling-options-2026-04-16.md
• gloriousflywheel-builder-surface-promotion-criteria-2026-04-15.md
• gloriousflywheel-nix-output-candidates-2026-04-15.md
• gloriousflywheel-runner-dashboard-*

Downstream Adoption And Benchmarking

• gloriousflywheel-downstream-adoption-inventory-matrix-2026-04-16.md
• gloriousflywheel-first-tranche-repo-contracts-2026-04-16.md
• gloriousflywheel-*-first-patch-playbook-2026-04-*.md
• gloriousflywheel-*-dogfood-playbook-2026-04-*.md
• gloriousflywheel-runner-benchmark-methodology-2026-04-16.md
• gloriousflywheel-benchmark-scorecard-template-2026-04-16.md
• gloriousflywheel-adoption-forge-and-competitive-reality-2026-04-16.md
• gloriousflywheel-github-first-forge-parity-2026-04-16.md
• gloriousflywheel-forge-support-matrix-2026-04-16.md

Historical Reset And Gap Notes

• gloriousflywheel-runner-platform-reset-2026-04-15.md
• gloriousflywheel-implementation-gap-matrix-2026-04-15.md
• attic-iac-host-tree-considerations-2026-04-15.md

These are still useful, but they are not the primary place to start.

How To Read This Directory

1. Read the public docs first.
2. Read the canonical active notes above.
3. Only then go into the supporting groups that match the question at hand.

That keeps planning detail available without making every note look equally authoritative.