← back to Docs source: system/seo/ONRAMP.md

ONRAMP — The Autonomous Onramp: Ramp, Graduation, Boot, Takeover

Status: DRAFT v2.0 — command-center review pending

Descends from: SYSTEM.md §3 (progressive commitment, the commit boundary), corpus/COMMISSIONING.md, bounded by VALUES.md V4/V6. The prototype specified the steady state superbly and the build weakly: an imperative "build-mode override," human sign-offs at five points, thresholds denominated in days. A machine whose premise is "runs itself from the launch command" cannot have a hand-operated onramp. The onramp is the machine, at different settings. Nothing is built twice; nothing is switched off by hand; the system that emerges is the system that built itself.


1. The build is declarative, bottom-up, self-graduating

There is no build-mode override. The same gated workforce that runs the system builds it, under a ramp configuration that loosens gates early and tightens them per-gate as evidence accumulates — degrading gracefully into standard production with no cliff, no global switch, and no human in the loop. Every build-phase change flows through the normal propose→gate→execute→review loop at loosened settings, leaving the same audit trail as production. The commissioning orchestrator's residual role shrinks to infrastructure that cannot flow through gates: installing scripts, provisioning.

2. Provisioning — the only hard human dependency

The only thing the system cannot do for itself is hold ML's keys (V4: credentials are granted, never derived). Provisioning — keys, accounts, domain, hosting, API access — is the single hard human dependency, and it is verified mechanically: a prerequisite check at launch enumerates every required credential and access, tests each, and blocks launch on any failure with a specific, actionable list. No judgment, no interview, no sign-off — a checklist a script runs.

Everything after provisioning that the prototype required a human for — strategic direction sign-off, personality approval, master-document approval, "turn the system loose" — is replaced by measurable exit criteria and the build review (§7). The human's console (force-pass, hold, demote, steer) is always available and never necessary.

3. The boot interview — a fork-tested question bloom

The prototype opened with a fixed 11-question kickoff form (including the gut-feel persona question). Both the fixed form and its shrunken successor ("provisioning + optional steering") are wrong — the first over-asks mechanically, the second under-provides for intent. Intent questions are un-eliminable by the world: no amount of research can tell the system what ML actually wants from this deployment.

Boot is an interview, and the interview is a bloom:

  1. The system generates candidate intent questions from the vertical seed and its own doctrine — monetization posture, risk tolerance, brand constraints, off-limits topics, takeover vs cold-start intent, success horizon.
  2. Each candidate is fork-tested: does the answer change what the system would build? Questions whose answers don't fork downstream work are eliminated, not asked. ML's attention is priced; questions are kept few and large.
  3. The bloom stops at saturation — when further questions no longer move the plan.

Heavy hour-zero intent escalation is CORRECT. At hour zero almost everything forks on intent, so the escalation rule fires constantly — that is the designed behavior, not a failure. The frequency decays by graduation: as answers accumulate into committed seed-intent artifacts and gates harden, fewer decisions fork on unknown intent, and human contact converges to the standing four-category floor (§8). The persona question never appears — the tournament answers it (seo/RESEARCH.md §3).

4. Ramp-as-config

"Build mode" is state, not prose. A machine-readable ramp configuration, consumed by every gate script, carries per-gate: phase, threshold, lookback, cadence, reviewer requirement, cooldown, and graduation criteria.

5. Cooldowns — damping as its own mechanism

Corroboration thresholds silently perform two jobs: filtering noise AND damping oscillation. Loosen a threshold to 1 and the damping vanishes — successive workers can thrash the system, executing a direction and its reversal in alternate runs.

Damping is therefore its own mechanism, decoupled from thresholds: a direction key that executes cannot re-fire, and its reversal cannot fire, for K epochs (default K=2) without escalation-path or console override. Enforced in the shared gate library, denominated in evidence epochs, not days. This is what makes threshold-1 building safe.

6. The model ramp

Early in a build, directives are unrefined and playbooks empty; a cheap model amplifies every ambiguity at exactly the moment errors shape foundations. So:

7. Build review — permanent layers at build settings

The prototype's build had no immune system: nothing reviewed the build against the design principles, and the ramp itself was unwatched. v2's answer is not a transient corps. Build review is the system's permanent monitoring and self-knowledge layers, running at build settings from day one:

Retirement discipline: reviewers retire on subject-completion only, never on silence. The ramp auditor stands down when the ramp ends — an observable event. Nothing retires because its defect-find rate went quiet: a silent-failure detector finding nothing is indistinguishable from its being needed. Any retirement criterion keyed to low find-rates must first be canary-verified — planted defects the reviewer must catch; a reviewer that misses its canary is broken, whatever else it reports.

Review criteria are staged, because what matters changes as the build matures:

Early review is throughput-enabling, not throughput-limiting: it keeps direction true while the valves are open.

8. Graduation — the definition

Graduation is not a ceremony and not a date. The system has graduated when, and only as long as:

Individual gates, workers, and reviewers graduate independently on their own criteria; system graduation is the aggregate those curves converge to. Nothing about it is irreversible — regression on the meters reopens ramp settings per-gate.

9. Takeover mode

Deployment onto an existing site changes the onramp's inputs, not its laws. The v1 framework is preserved:

  1. PLAN — independent of the existing site. Run the full research blitz and build-out planning as if the site did not exist, producing the ideal state: expertise pyramid, concept map, beat structure, architecture blueprint, persona tournament. Plan-first is load-bearing: audit-first anchors on what exists and produces "improve what we have" instead of "build what should exist." The gap between ideal and actual IS the work plan.
  2. AUDIT — against the plan. Inventory all existing content: crawl, categorize, quality-assess; pull rankings, traffic, backlinks per page; map every page to the plan's concept map.
  3. DECIDE — keep / rewrite / merge / nuke / reclaim, data-informed per page:
      • KEEP — ranking well, good quality, on-strategy: preserve and integrate.
      • REWRITE — rankings or topic value with poor execution: through the pipeline.
      • MERGE — multiple pages on one target: consolidate, redirect the rest.
      • NUKE — no traffic, no rankings, low quality, or off-plan: delete, redirect to the nearest relevant node.
      • RECLAIM — ranking for an unintended keyword, or backlinks without traffic: re-optimize or redirect to preserve equity. The decision set is a gated commit at high consequence — it forks the site's SEO equity — with the decisions ledgered per page.
  4. BUILD / OPERATE — the normal ramp (§1–8), with kept content entering the map as coverage, rewrites entering the pipeline as drafts, and redirect topology owned by the organizational-pipes surface (seo/FLOOD.md §6.3).

Takeover's SEO-equity risk (legacy cannibalization, authority dilution) is why the audit must be exhaustive and the decide step sits high on the consequence dial.

10. What changed from the prototype

Prototype (v1)v2
Build-mode override, imperative, proseRamp-as-config; the workforce builds the system through its own loosened gates
Five human sign-offs + 14-day deadlock fallbackProvisioning as the only hard dependency; boot-interview bloom; humans at the four-category floor
Fixed 11-question kickoff incl. gut-feel personaFork-tested question bloom; hour-zero escalation heavy by design, decaying by graduation
Day-denominated thresholds; calendar phasesEvidence-based per-gate graduation; days survive only as staleness ceilings
No hysteresis theoryCooldowns: executed direction + its reversal locked for K epochs
Static model assignmentModel ramp: launch capable within the ceiling, demote per-worker on maturity, reversible
Transient Build Review Corps, self-retiring on quietPermanent monitoring/self-knowledge layers at build settings; retire on subject-completion only, canary-verified
Takeover: plan → audit → keep/rewrite/merge/nuke/reclaimPreserved intact, re-gated at consequence

11. Open items