Rpi

RPI

Run one experiment from the caller's existing intent source through three

responsibilities and stop:

Plan -> Implement -> fresh Validate -> report

RPI preserves the original intent and dispatches each core phase at most once.

It does not own retries, budgets, queues, claims, leases, Git, delivery, release,

closure, or the caller's next decision.

The pure scripts/run_once.py reference behavior makes

the dispatch and stop semantics executable without Git, ao, or a tracker.

Admission and phase lock

RPI activates for any request shaped as plan-execute-verify work —

orchestration, worker delegation, "execute this plan", or an explicit

Plan -> Implement -> Validate ask — whenever the goal includes changing the

subject. The caller does not have to name RPI. Research-, audit-, and

review-only delegation is not RPI admission: it produces evidence for a

caller, has no implementation candidate, and never earns a verdict.

Once the caller has accepted a plan — including a duel or design synthesis —

Plan is closed for that intent. Every subsequent lane must return

implementation evidence: diffs, commits, test results, or factual receipts.

Dispatching another planning, audit, or review lane over the same intent

requires new explicit caller authorization; a review comment is never that

authorization by itself.

Contract

• Resolve the existing bead or caller intent. Invoke Plan once only if that

source needs shaping; Plan updates the same source or proposes an amendment.

It creates no AgentOps packet. The runtime snapshots the exact resolved

source bytes under their digest, including when the conversation is the only

source, before dispatching Implement or a fresh Validate context. If usable

intent cannot be established, report NOT_PLANNED and stop.

• Invoke Implement once with the resolved intent. It performs one bounded

experiment; the runtime derives subject identity and check receipts. If no

subject is built, report NOT_BUILT and stop.

• Invoke Validate once in a context distinct from the author's context. Pass

the intent reference and digest, exact subject manifest, factual receipts,

validator identity, and freshness attestation.

• Return the fresh validation result and a short report. Persist and link

verdict.v2 only when the caller requests machine-readable evidence or a

declared downstream consumer requires it. Stop regardless of PASS, FAIL,

or NOT_PROVEN.

NOT_PLANNED and NOT_BUILT are report statuses, never semantic verdicts.

A caller may revise the bead or caller intent and start a new invocation. RPI

never creates a parallel revision artifact or selects the next work itself.

Proportionality guard

RPI does not turn each component, gate failure, or specialist comment into a

new planning artifact. A terminal caller goal

may remain one bounded experiment across several source owners when they serve

one outcome and one acceptance boundary.

If control artifacts or fresh-validation cycles are multiplying faster than

implementation evidence, stop dispatching more lanes. Return to one

outcome-level intent and continue with targeted deterministic checks, reserving

the full integration check and fresh validation for the frozen subject. This

changes orchestration cost, never acceptance, exact identity, fail-closed

scope, or validation authority.

Continuation envelope

Before dispatching any lane, the orchestration declares its envelope: a budget

(maximum lanes per wave, maximum repair revisions per wave) and a checkpoint

rule — the second non-PASS outcome on one intent stops that lane and returns

to the caller instead of dispatching another attempt. The envelope includes a

spiral breaker: two consecutive control artifacts (plans, audits, reviews,

prompts, reports) produced with no new implementation evidence terminate the

run — report NOT_BUILT when no implementation subject exists yet;

when a subject already exists, stop and report its current status without

dispatching further lanes. Neither breaker dispatches a repair revision. An

orchestration without a declared envelope does not converge; it accretes

lanes. For example, a plan that keeps failing acceptance on the same criterion

might tempt three intent revisions in a row

(.agents/ao/intents/sha256/<rev1>... superseded by <rev2>... superseded by

<rev3>...) chasing a NOT_PROVEN then a second NOT_PROVEN

(.agents/ao/verdicts/sha256/<verdict1>..., <verdict2>...) — the declared

envelope's two-stop checkpoint ends the wave there instead of dispatching a

third attempt.

Delegate with minimal context: a lane receives the frozen intent reference and

the established facts it needs, never the orchestrator's full conversation

history. If a lane cannot proceed from the intent alone, the plan failed the

fresh-context test and should be repaired at the source, not padded with chat

transcript.

Lanes whose write scopes share a regen surface (the same generated outputs,

mirrors, or manifests) serialize; only lanes with disjoint source scopes and

disjoint regen surfaces may run in parallel.

Invariants

• Acceptance and its runtime-derived digest do not change between phases.
• The runtime derives complete changed-path coverage or Validate returns

NOT_PROVEN.

• A proven change outside write_scope makes the verdict FAIL.
• PASS requires nonempty distinct author and validator context IDs plus an

explicit freshness attestation.

• Optional Premortem, Postmortem, Council, genie, factory, tracker, and runtime

adapters are caller-selected. They do not alter phase order or core outcomes.

When a factory adapter is selected, work enters it through that factory's

coordinator (for Gas City, the Mayor — see

using-gc); RPI hands over intent and never dispatches

factory runs itself.

• Learn is an optional later consumer of verdict collections and is not part of

this invocation.

Report

RPI has one required report surface and one optional representation:

• Interactive response: return the result to the caller in natural

language. This is the default assistant response.

• Machine artifact: return or persist the exact rpi-report.v1 object

only when the caller requests machine-readable evidence or a declared

adapter consumes it. The schema ships in a repo checkout at

schemas/rpi-report.v1.schema.json; the minimal required shape is:

   {
     "schema_version": "rpi-report.v1",
     "status": "PASS",
     "intent_ref": ".agents/ao/intents/sha256/<64-hex-digest>.intent",
     "acceptance_digest": "<64-hex-char-sha256-or-null>",
     "subject_manifest_digest": "<64-hex-char-sha256-or-null>",
     "verdict_ref": "<verdict-location-or-null>",
     "verdict_digest": "<64-hex-char-sha256-or-null>",
     "checked": ["<criterion satisfied by evidence>"],
     "not_checked": ["<criterion not covered>"]
   }

status is one of PASS | FAIL | NOT_PROVEN | NOT_PLANNED | NOT_BUILT; the

three digest fields, when present, are 64-character lowercase hex SHA-256

strings; checked and not_checked are arrays of strings. All nine keys

are required (use null for an inapplicable ref or digest), and no

additional properties are allowed.

Lead the interactive response with the status and one sentence stating the

caller-visible outcome. Lead with the subject, not the process: production

paths changed, commits, test results, and acceptance criteria satisfied or

remaining. A rising artifact count over an unchanged subject is a stop

signal, not progress. Follow with only the strongest proof, any material

unchecked scope, and a clickable verdict reference when one exists. Name why

no subject exists for NOT_PLANNED or NOT_BUILT. Keep the response to one

short paragraph or at most four bullets.

When no machine artifact was requested, do not create a hidden one. Raw digests,

schema fields, and exhaustive check lists stay out of the interactive response

unless an integrity failure makes one necessary to explain the result.

Do not append a next action. The caller owns continuation.