The seed already exists and was witnessed working: planted in a repo, it wires itself, verifies with the repo’s own checks, and opens the PR — the next real CI run banks the proof. This page decides the last mile: make it work on every soil, make it say READY and PROVEN on its own, and plant it everywhere — with no machine in the middle reading your fleet.
Draft for Robert’s annotation · not approved · no building yet
v2 — reframed on your correction: v1 spec’d a central sweep that reads every repo from one machine. Cut. The product is the seed — the package planted in a repo that knows what to do, wires itself, and proves itself. Covering the fleet is then just planting.
01
Decisions locked
Consistent with everything already ratified — red-pen any of them, but the build assumes these.
Ownership
The owner’s hand stays on the merge — once
The seed opens PRs; it never pushes to a default branch, never merges. One merge, then the owner forgets it exists — every agent session in that repo is born wired from then on.
Honesty
Fail closed on strange soil
A repo the seed can’t confidently wire gets a plain refusal with a named reason — never a guess, never a silent skip.
Proof
Real receipts are the only DONE
Green unit tests don’t count — the runner.temp bug hid from 60 tests and two engines; only real CI exposed it. DONE = a bot receipt banked on real CI.
Shape
Seed-first — the central sweep is cut
No enumerate-classify-orchestrate machine. One line per repo; the seed does all the thinking inside the repo it lands in.
Preservation
Nothing the fleet sheds is throwaway
Your v2 rider, locked: every receipt is durable in the repo’s own history, uniform in shape, pinned to its commit — and the registry knows every member. The org world model stays buildable later (§05).
02
The journey — from a witnessed seed to a fleet that reports itself
Follow one repo from planting to proof.
The seed already works — witnessed yesterday, on clean soil.Planted in a repo, it sizes the repo up from the inside: finds the repo’s own checks (never invents any), adds exactly the missing wiring on a branch, runs the repo’s own verification once, opens a ready-to-merge PR. Owner merges — and that’s the last attention the repo ever needs. From that moment every agent session opened there is born into a wired world: the map, blast-radius answers, receipts on every green. Install, forget, and the agents simply have that environment. Brand-discovery sprouted exactly this way.↘ go deeper — the seed, concretely
Install once per machine: curl -fsSL https://get-quanta.robert-767.workers.dev/install.sh | bash (self-checking, plain-English errors, re-run to upgrade). Plant once per repo: quanta onboard --apply --pr — assess → identify the repo’s own verification entry → prepare exactly the missing pieces on chore/quanta-level-2 → run the entry once → open the PR. A small optional wrapper (install.sh --onboard) collapses install+plant into one paste.
Fix the soil it lies on — the load-bearing step.Three burrs, all found in the field: repos wired the OLD hollow way get told “nothing to do” (a false green on arby, de-brain, sandbox-hub) · the seed refuses when its branch already exists even if you’re standing on it · the health check shows one false ✗. Until these land, planting lies on some repos.↘ go deeper — the fixtures that prove the fixes
(a) A fixture carrying the old inline mint line (plato deposit … || echo skipped) MUST route to the upgrade path — can never read “nothing to do.” (b) On-the-branch planting resumes instead of refusing. (c) The doctor false-✗ reproduced, then fixed. All three are already chipped as tasks; every fix becomes a permanent test (the 6-refute-cycle discipline).
It tells you when it’s proven — the new piece.Today the receipt lands and nobody says so. This build adds the sprout verdict: READY (wired, self-check passes) then PROVEN (the actual bot receipt exists on the repo’s home branch). And the fleet view gets a receipts column — the whole fleet’s proof state on one screen, without opening a single repo.↘ go deeper — how PROVEN stays honest
PROVEN is mechanical: the home branch carries a github-actions[bot] banking commit whose currency pin equals the attested SHA. Anti-vacuity gate: a fixture with the receipt stripped MUST flip PROVEN off — a verdict that can’t go red is no verdict. The fleet view’s column reads the same check and renders CANNOT-SEE when a source is unreachable — never a false green.
Plant the fleet.No central machine. Each of the ~15 service repos gets the seed planted — by its owner pasting one line, or by me in an isolated clone (your call below). Output is one table: planted · upgraded · already-current · refused: reason. Then everyone watches the receipts column, not the repos.↘ go deeper — the planting round
An operation, not a build: fresh isolated clone per repo → plant → PR. Re-planting is idempotent (already-current → verify only, no new PR). Rollback is per-repo: close or revert one PR. Post-merge DONE is read from the fleet receipts column, recomputed from raw via the GitHub API — never from a worker’s summary.
Born planted — the strongest form.The assembly-line template gets the seed once, in your neuron repo, so every future client site comes out already wired — the ~40-site pile never needs planting at all. PR waits at your pull point; never your live checkout.↘ go deeper — coordination + tokens
Client-site repos live in the Digital-Empathy org, so the existing QUANTA_INSTALL_TOKEN org secret already covers their banking — no new token work. Template change is a normal PR against neuron worked from a clone (the concurrent-writer scar stays respected).
The rule: the seed never guesses. Strange soil gets a plain refusal with a named reason, and every planting lands in the table — planted, upgraded, already-current, or refused: why.
03
Your calls — the red-pen targets
1 ★
Go / no-go on the build.
This page is the whole decision. On “go,” the full sequence runs: independent review of the build spec before code, receipts before “done.”
2
Who plants.
Owners paste the line in their own repos (your announcement already primed them), or I plant the ~15 service repos from isolated clones and owners just merge? Rec: I plant, owners merge — the shape they’ve already seen.
3
Token timing.
Your personal org’s repos can be planted now but can’t bank receipts until your one-time token step (your hands only — a token pasted into chat is burned). Until it lands, those repos show in the fleet view as wired — not yet proven: a visible named state, not silence. Rec: plant anyway.
4
Factory template.
I prepare the neuron-side PR so every future client site is born with the seed already planted, and leave it at your pull point. Rec: yes — it kills the ~40-site pile at the source.
04
Honest hard problems
Soil variety
Every repo’s CI is a new case. The seed was right on all six re-stamp repos — but each new repo is a new shape. Mitigation: fail-closed refusals with named reasons; receipts-only DONE.
The old-wiring false green
Until the seed recognizes the old hollow form, it tells those repos “nothing to do.” That fix ships first or planting lies.
Silence after planting
Without the PROVEN verdict, “did it sprout?” still means going to look — the exact center-reading this build exists to end.
The kill criterion
If more than a third of plantings end in “refused — needs hand-holding,” the seed isn’t ready. Stop and fix the seed — never answer that failure with central machinery. That’s v1’s frame sneaking back.
05
The org world model — later, preserved now
Your rider, kept whole: eventually pour everything the seeds shed into one database and see the seams between the repos — which are connected, which talk to each other, which carry similar ideas or potential synergies. The entire org’s world model. Not this build. This build’s guarantee is the raw material: receipts durable in each member repo’s own history · one writer, so one uniform shape across the fleet · every receipt pinned to its exact commit · the registry enumerating the members. The world model becomes a straight read later, never a migration — and the fleet receipts column below is deliberately the first tiny version of exactly that kind of read.
06
Phasing
P1
Soil fixes
The three chipped burrs, each with a fixture that makes the old failure impossible. Blocks planting — without them the seed lies on known repos.
P2
Prove-itself
The READY → PROVEN verdict + the fleet receipts column. Optional one-paste wrapper.
P3 · parallel
Born planted
Seed into the site factory’s template — the deep fix for the biggest pile. Different repo, your pull point.
The planting round itself is an operation, not a phase — it happens after P1–P2 land, per your call #2.
07
How we’ll know it works
Three receipts, all mechanical: (1) planting any of the three old-form repos routes to UPGRADE — never “nothing to do”; (2)quanta doctor in a sprouted repo answers PROVEN by pointing at the actual bot receipt on the home branch — and refuses to say it when the receipt is stripped; (3) after the planting round, the fleet view shows every planted repo’s receipt state without anyone opening those repos. The step-back, answered: the seed is the product; the factory template plants it at birth; after both, wiring costs nothing, forever.