Build PAA / Implementations

The code carries the detail

These implementations map task boundaries, evidence, and authority changes to real code, and state what each system leaves out.

Normative executable reference

paa-runtime

A Python control plane that validates task declarations, persists evidence, determines promotion eligibility, records authority decisions, and retains event history.

Task declarationVersioned, schema-validated task and scope

EvidenceAdmissible records bound to evaluator and task versions

DecisionPromotion or demotion proposal with explicit resolution

TransitionAppend-only event history and exact-scope position fold

Does not implement: worker execution, evaluator execution, or application-level atomicity for the governed effect. Those remain consumer responsibilities.

Repository Run the refund quickstart Implementation mapping

Application integration

Scout

Scout embeds paa-runtime in an application that monitors Discord, Farcaster, and Bluesky, evaluates relevance, drafts engagement comments, and presents results to an operator. Outbound content creation and publishing live in a separate application.

Scout declares two PAA tasks: inbound_reply_surfacing, deployed in shadow mode, and canonical_promotion, currently disabled. Its application database stores PAA events and resolves autonomy position by exact task, declaration version, and scope.

paa-runtimeDeclarations, evidence, decisions, event history, and position resolution

ScoutEvaluator-producer bindings, persistence adapters, application evidence, operator surfaces, and integration boundaries

DeferredActive runtime enforcement for the two current Scout tasks

Does not demonstrate: an actively enforced production autonomy transition. Scout's grading and feedback loop has produced production-derived evidence, which stays deployment-local and is exported only in redacted, publication-safe form, while its checked-in PAA tasks remain in shadow or disabled deployment. Its publication-safe PAA evidence is explicitly labeled as reference/replay evidence.

Repository Three-minute evidence tour PAA architecture in Scout Reference evidence

Compatible substrate

jig

jig provides bounded execution, typed results, evidence logging, and pluggable graders that map cleanly to parts of PAA.

Does not implement: authority positions, promotion rules, demotion rules, or transitions.

Repository Mapping

Looking for reusable task shapes rather than code? See Patterns.