repo-evolution.yml — a draft PR into a submodule's own upstream

repo-evolution.yml — a draft PR into a submodule's own upstream A sequence diagram generated by Archify. dispatch read auto_evolve opt-ins + triage candidate repos probe token · find open evolution PRs capped matrix (one open PR per repo) matrix JSON + brief checkout, no persisted credentials brief: failing workflows, open issues working-tree diff commit as bot · draft PR, marker first draft PR to review merge (never the agent) Plan (deterministic) Execute (bounded) Human review Weekly cron · fleet.yml evolution · Sequence participant Weekly cron fleet.yml evolution plan job · dash-gen targets · Sequence participant plan job dash-gen targets _data/ · registry + triage · Sequence participant _data/ registry + triage GitHub API · FLEET_TOKEN · Sequence participant GitHub API FLEET_TOKEN evolve job · matrix, per repo · Sequence participant evolve job matrix, per repo Opus agent · read-only allowlist · Sequence participant Opus agent read-only allowlist Upstream repo · bamr87/<repo> · Sequence participant Upstream repo bamr87/<repo> Maintainer · reviews · Sequence participant Maintainer reviews Legend request return security async trace default message

Plan before paying

  • • Only owned, non-archived submodule opt-ins
  • • A still-open previous PR is the backpressure
  • • Token and Claude auth are probed before any agent

Bounded execution

  • • One agent per repo on a credential-free checkout
  • • Read-only allowlist; the workflow commits as the bot
  • • The brief keeps it out of the doctor's and pipeline's lanes

Across the fleet

  • • The PR lands in the submodule's own upstream
  • • The hub records the new pointer only after a human merges
  • • test_evolution.py asserts the workflow against fleet.yml