SKRSI is the evidence-first improvement control plane for SK software lifecycle orchestration. It measures delivery, evaluates bounded experiments, records lessons, and proposes safer changes. Then it stops and hands the decision to somebody else.
SK Recursive Systematic Evaluation, Learning, and Feedback Improvement
Most "self-improving" systems fail in the same place: the thing that measures the work is also the thing allowed to approve it. SKRSI is built so that collapse is structurally impossible.
A valid SKRSI record confers no merge, deployment, credential, or actuation power. Feedback is proposal-only, and it routes through the adopter's existing authorization gates.
Producer and independent evaluator identities must differ, enforced through an ordered, unique evaluation participant tuple. The measurer does not get to certify the measurement.
An observation does not become an actuation by passing through the system. An inconclusive experiment stays inconclusive, and no model, agent, or operator can relabel it as a success.
Four ordered stages. Each one constrains the next, and the order carries the guarantee.
Work from declared targets, cohorts, metrics, and stop rules. A target registers its own invariants, expiry, and rollback owner before anything is measured.
Compare evidence without inventing causality or hiding missingness. A PASS needs numeric baseline and treatment values for every metric, no failed guardrail, and no explicit missingness entry.
Preserve outcomes and lessons as versioned, attributable records. Failed and inconclusive runs are kept with the same care as successful ones, because those are the ones that carry information.
Route bounded proposals back to the responsible lifecycle agent. The existing gates stay authoritative. SKRSI never becomes the thing that says yes.
Every edge has one producer, one consumer, a bounded queue, a timeout, a retry policy, a recovery owner, and immutable terminal evidence.
Both branches return to the target. That return path is the only recursion in the system.
Metadata-only records, each declaring an exact schema URI. A consumer must reject unknown major versions, and must not infer authorization from a valid record.
| Contract | Schema | Purpose |
|---|---|---|
| Target | target-v2 |
Registers a bounded objective with measures, invariants, stop rules, expiry, and a rollback owner. |
| Event envelope | event-envelope-v1 |
Carries attributable metadata, lineage, hashes, and redaction class. |
| Evaluation | evaluation-v3 |
Records independent participants, complete PASS metrics, quality gates, missingness, and an evidence-bound outcome. |
| Feedback handoff | feedback-handoff-v1 |
Routes a proposal to an existing authority without granting permission to act. |
Three cumulative levels. Each one contains the one before it, so a claim at the top implies everything below.
git clone https://github.com/smilinTux/skrsi
cd skrsi
python3 -m unittest discover -s tests -v
python3 scripts/validate_public.py .