Skip to content

docs: follow-up plans for template-inheritance gaps - #65

Merged
twistedmelonman merged 1 commit into
mainfrom
docs/template-inheritance-followup-plans
Apr 30, 2026
Merged

docs: follow-up plans for template-inheritance gaps#65
twistedmelonman merged 1 commit into
mainfrom
docs/template-inheritance-followup-plans

Conversation

@twistedmelonman

Copy link
Copy Markdown
Member

Summary

Three plans addressing the question raised in this session: how do reusable workflows here propagate through <owner>/.github to consumer repos? The investigation surfaced two structural facts and three independent gaps to close.

The facts:

  • smartwatermelon is a user account, not an org. GitHub's workflow-templates/ picker is org-only, so the workflow-templates/ directory in smartwatermelon/.github never surfaces in any UI.
  • nightowlstudiollc IS an org (team plan), but has no .github repo yet, so it inherits no defaults at all.

The plans:

  1. bulk-install-smartwatermelon-fleet — script-based workaround for smartwatermelon, since workflow-templates won't ever auto-propagate there.
  2. create-nightowlstudiollc-github-defaults — stand up nightowlstudiollc/.github so the picker works for new repos in that org.
  3. required-workflows-nightowlstudiollc — force-enforcement via Repository Rulesets. (GitHub deprecated standalone Required Workflows in 2023 in favor of Rulesets — got that wrong in my first draft, corrected before commit.)

Cross-references between plans are wired up. Order of execution would be 2 → 1 → 3, with 3 in audit-only mode for a calibration window before activation.

The companion fix to smartwatermelon/.github/workflow-templates/claude-blocking-review.yml (bumping the stale @v2.0.1 pin to @v3.0.0) is in flight at smartwatermelon/.github#7.

Test plan

  • markdownlint passes (auto-fix applied — angle-brackets around bare URLs, blank lines around lists)
  • Cross-references between plans resolve
  • Required Workflows ↔ Rulesets correction reflected in all three docs
  • CI green

🤖 Generated with Claude Code

Three plans addressing the gaps surfaced by the question of
how reusable workflows propagate from this repo through
`<owner>/.github` to consumer repos:

1. bulk-install-smartwatermelon-fleet — workaround for the fact
   that `smartwatermelon` is a user account, so workflow-templates
   never appear in the picker UI for `smartwatermelon/*` repos.
   Script-based opt-in install across the existing fleet.

2. create-nightowlstudiollc-github-defaults — stand up the org's
   `.github` repo so workflow-templates do work for new repos in
   that org, plus mirror community defaults.

3. required-workflows-nightowlstudiollc — force-enforcement via
   Repository Rulesets (GitHub deprecated the standalone Required
   Workflows feature in 2023; Rulesets are the live mechanism).
   Audit-only first, escalate to active.

Plans cross-reference each other and call out the order/dependency
between them. Smartwatermelon→org migration is explicitly out of
scope per current direction.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@twistedmelonman
twistedmelonman merged commit 07fffc8 into main Apr 30, 2026
3 checks passed
@twistedmelonman
twistedmelonman deleted the docs/template-inheritance-followup-plans branch April 30, 2026 16:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant