Skip to content

chore(distributor): retire — org Required Workflows replace caller injection#34

Merged
JacobPEvans-personal merged 1 commit into
mainfrom
chore/retire-distributor
May 31, 2026
Merged

chore(distributor): retire — org Required Workflows replace caller injection#34
JacobPEvans-personal merged 1 commit into
mainfrom
chore/retire-distributor

Conversation

@JacobPEvans-personal
Copy link
Copy Markdown
Member

Summary

  • Retires The Distributor. The cloud routine's trigger_id is documented in the new AGENTS.md "Retired routines" section; the prompt file deletion happens on feat/six-new-routines (PR feat(routines): rewrite six new routines, ground-truthed and hardened #20) before that branch merges.
  • Adds docs/DISTRIBUTOR_RETIREMENT.md with the full operator-only migration runbook (delete cloud routine, configure org Required Workflows per tier, honor existing opt-outs, hard-excludes, personal-account decision tree, verification).

Closes #28.

Why

  • DRY violation: distributing thin caller YAML to every repo via per-repo PUTs is exactly what GitHub org Required Workflows do natively (with no per-repo file).
  • No state to preserve: no distributor-state gist exists (the cloud routine never ran successfully).

What changed

  • AGENTS.md — adds "Retired routines" section with the Distributor entry (trig_01HoVTrJjo41JFEyzmY1tU5b).
  • docs/DISTRIBUTOR_RETIREMENT.md — operator runbook: 4 tiers (core/tests/nix/terraform), per-tier selector + workflow list + secrets, opt-out audit, hard-excludes, personal-account trade-offs, verification checklist.

Coordination with other open PRs

User-only follow-up steps (documented in DISTRIBUTOR_RETIREMENT.md)

  1. Delete the Distributor cloud routine via claude.ai/code/routines UI.
  2. Re-launch Claude with gh-claude-org-admin for GH_PAT_ORG_ADMIN access.
  3. Configure 4 org Required Workflows per the tier table in DISTRIBUTOR_RETIREMENT.md.
  4. Audit existing skip-distributor topics and translate to per-tier repo exclusions.
  5. Decide per personal repo: migrate to dryvist, maintain manually, or accept drift.

Test plan

  • CI green (markdown lint).
  • After merge + step 1: RemoteTrigger get trigger_01HoVTrJjo41JFEyzmY1tU5b returns 404.
  • After merge + step 2-3: test PR in one dryvist repo per tier fires the right reusable workflows with no caller file present.
  • One week post-retirement: 5 random consumer repos still get link-checker, ci-doctor, etc. runs via Required Workflows.

…jection

The Distributor was supposed to propagate thin workflow callers from
ai-workflows into every estate repo via per-repo Contents API PUTs.
With the dryvist org migration, GitHub Required Workflows handle that
need natively — zero per-repo caller files.

The Distributor prompt itself only ever lived on the feat/six-new-routines
branch (PR #20, still open); it never landed on main. This commit:

- Adds AGENTS.md "Retired routines" section with the Distributor's
  trigger_id (trig_01HoVTrJjo41JFEyzmY1tU5b).
- Adds docs/DISTRIBUTOR_RETIREMENT.md with the full migration runbook:
  per-tier Required Workflow configuration, opt-out handling, hard-
  excludes, personal-account trade-offs, and verification steps.

No distributor-state gist exists (the cloud routine never ran successfully),
so there is no operator-decision history to preserve from state.

Follow-up actions for the user:
1. Delete the Distributor cloud routine via claude.ai/code/routines UI.
2. Configure org Required Workflows per docs/DISTRIBUTOR_RETIREMENT.md.
3. Decide per-repo whether JacobPEvans-personal repos migrate to
   dryvist, maintain callers manually, or accept drift.

On the feat/six-new-routines branch: routines/distributor.prompt.md
should also be deleted before that branch merges. This PR does not
touch that branch — that's a separate edit on PR #20.

Closes #28

Assisted-by: Claude <noreply@anthropic.com>
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.

chore(routines): retire The Distributor — replaced by org Required Workflows

1 participant