Architecture ยท Evidence before claims

A pipeline where each authority stays in its lane.

Skivolve separates source identity, agent generation, objective verification, comparator judgment, provider capability, spend accounting, and holdout authority. A result advances only when the relevant layer has evidence.

Evaluation flow

From exact source to reviewable artifact.

  1. Strict manifest

    Duplicate-key rejection and schema validation establish the suite, cases, variants, modes, providers, limits, and artifacts.

  2. Git-bound variants

    Control, candidate, and no-skill arms resolve to exact, non-identical per-case sources before dispatch.

  3. Provider adapter

    A reviewed capability registry determines roles, concurrency, sandbox, billing evidence, provenance, and authority scope.

  4. Isolated workspace

    The harness works on a fixture copy while source, verifier resources, credentials, and unrelated host paths remain separated.

  5. Objective oracle

    A bounded case verifier evaluates declared behavior against the produced workspace diff, final text, or final JSON.

  6. Eligible comparison

    Where the suite permits judgment, a locked calibrated profile compares anonymized AB and BA presentations.

  7. Evidence gates

    Source drift, protocol locks, artifacts, spend, provider provenance, holdout consumption, and certification close independently.

Authority map

No output gets to authorize itself.

Skivolve authority boundaries
QuestionAuthorityWhat cannot answer it
What source ran?Git object and canonical source fingerprintPrompt text or provider response
Did behavior pass?Case-specific objective verifierCompilation alone or model self-report
May ambiguity be judged?Suite mode and comparator profileProvider name or result field
May this provider act?Immutable reviewed capability registryManifest-supplied arbitrary imports
Was spend bounded?Dispatch journal and configured ceilingsSuccessful calls alone
Can this support a release?Private frozen suite, independent review, consumed plan, and required certificationPublic validation scores

Reproducibility

The run records more than a score.

Identity

Suite bytes, case trees, exact commits, per-case bundle sources, runtime adapters, schemas, and release locks.

Execution

Provider and model identity, requests, dispatch state, time and spend ceilings, output artifact, and verifier outcome.

Decision

Objective evidence, eligible comparator evidence, AB/BA ordering, calibration support, aggregation, and gate status.

Compatibility

Schema evolution is separate from package versioning.

The Python package follows Semantic Versioning before 1.0. Manifest schemas, corpus versions, comparator protocols, provider capability revisions, holdout plans, and canonical artifact namespaces are independent public contracts. They change only when their own migration semantics require it.

Current schema 7 adds explicit workspace-diff, final-text, and final-JSON artifact contracts. Older supported schemas retain their declared compatibility behavior rather than being silently rewritten.

Inspect the executable architecture in runner.py, manifest.py, and comparator_runtime.py.