diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 80f7ad2c0..5d30a666b 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -241,7 +241,8 @@ the surface itself). Expected values are either worked out in closed form
(`tools/oracle-analytic/`) or computed by building the same recipe in FreeCAD, run as a separate
program (`tools/freecad-oracle/`); each file says which. The generated
[reference test report](docs/oracle.md) has the current case count and results. The reference-test
-CI job runs `cargo xtask oracle` during full validation; pull-request runs skip it. A case that
+CI job runs `cargo xtask oracle` during full validation, and on pull requests that reach
+`solidcraft-cli`. A case that
fails because of a known bug names its issue in `expected.json` (`"known_failure": "#123"`);
never change an expected value to match SolidCraft's output.
diff --git a/skills/solidcraft-tests/SKILL.md b/skills/solidcraft-tests/SKILL.md
index 4f4798f06..4a6113881 100644
--- a/skills/solidcraft-tests/SKILL.md
+++ b/skills/solidcraft-tests/SKILL.md
@@ -25,6 +25,8 @@ A failing test without its fix cannot merge: it turns `main` red for everyone. I
## Goldens, matrices and skipped tests
- The reference for what the kernel builds is the kernel-cases ladder (`tests/kernel-cases/ladder/`, `cargo xtask kernel-cases --ladder`, `docs/kernel-ladder.md`).
+- Kernel PRs run the kernel rig gate (`kernel-rig.yml`): each area against its `KNOWN_FAILING`, the ladder against its golden. In the same PR, a fix removes its line, a new failing case adds one, a changed ladder result is re-recorded (`--ladder --record "why"`); see `tests/kernel-cases/README.md`.
+- Maintainers' PRs run the native, GPU path and reference tests on the affected packages; others wait for `approved-for-ci`. `release-gate.yml` runs everything in full before develop replaces main.
- The action matrix is a ratchet: record a newly passing action with `cargo xtask action-matrix --bless` (`docs/action-matrix.md`).
- Pull requests skip a few heavy tests, which run in the merge queue, nightly and on `main`. Check that validation after merging. The list is in `.config/nextest.toml` and the testing page.
- Mutation testing finds behaviour the suites miss: `docs/mutation-testing.md`.
diff --git a/tests/kernel-cases/README.md b/tests/kernel-cases/README.md
index 632291ac5..f130ef323 100644
--- a/tests/kernel-cases/README.md
+++ b/tests/kernel-cases/README.md
@@ -97,27 +97,43 @@ the frozen truck-geometry PRs, a `kernel-paused` PR), for the report's coverage
| `tolerance` | Optional overrides: `rel`, `abs_mm`, `mesh_mm`, `weld_mm`. |
| `missing` | A capability SolidCraft has no command or parameter for yet (`"solid.thread has no start count"`): the case is reported **not supported yet** without running, so the gap stays visible. |
-## The fillet gate
+## The kernel rig gate
-The fillet cases are the fillet regression suite: each is one small case of one issue, with its
-exact answer. `.github/workflows/fillet-rig.yml` runs them on every pull request (not a draft)
-that touches fillet code: `crates/kernel/src/{blend*,fillet*,*corner*,continuity*}.rs`,
-`crates/smlib/**` (`SMLIB_REV` and `SMLIB_PREBUILT` included), `crates/doc/src/eval*.rs`,
-`crates/engine/src/cmd/features.rs`, `tests/kernel-cases/fillets/**` and the rig's own code
-(GitHub filters whole files, so any change to `eval*.rs` or `features.rs` runs it). One release
-build of `solidcraft-cli`, then:
+Every area is a regression suite: each case is one small case of one issue, with its exact
+answer. `.github/workflows/kernel-rig.yml` runs them all, and the ladder, on every pull request
+(not a draft) that touches the kernel surface: `crates/kernel/**`, `crates/geom/**`,
+`crates/smlib/**` (`SMLIB_REV` and `SMLIB_PREBUILT` included), `crates/step/**`,
+`crates/doc/src/eval*.rs`, `crates/engine/src/cmd/features*.rs`, `tests/kernel-cases/**` and the
+rig's own code (GitHub filters whole files, so any change to `eval*.rs` or `features*.rs` runs
+it). Pushes to main and develop on the same paths, merge groups and the release gate
+(`release-gate.yml`) run it too. One job builds `solidcraft-cli` (release, SMLib) and the rig's
+runner, and hands both to a matrix of shards, one per area plus the ladder, that run in
+parallel; the `kernel-rig` check passes when every shard does. (`fillet-rig.yml`, the earlier
+fillet-only gate, folds into it.) Each area's shard runs:
```sh
-cargo xtask kernel-cases --area fillets --cli target/release/solidcraft-cli \
- --known-failing tests/kernel-cases/fillets/KNOWN_FAILING
+cargo xtask kernel-cases --area --cli target/release/solidcraft-cli \
+ --known-failing tests/kernel-cases//KNOWN_FAILING
```
-`fillets/KNOWN_FAILING` lists the cases that fail today, sorted, one a line with its cause
-(` `; `#` starts a comment). The gate fails on a **regression**, a case
-that fails (or crashes, hangs, or is not supported yet) and is not listed, and on a **fixed** case,
-one listed that passes: a fix removes its line in the same pull request, so the list only shrinks.
-A new case that fails today goes in with its line. With `--known-failing` the run writes no
-report; `docs/kernel-cases.md` stays the full run's.
+`/KNOWN_FAILING` lists the cases of that area that fail today, sorted, one a line with its
+cause (` `; `#` starts a comment; the header names the baseline: the
+develop commit and SMLib revision it was taken from). The gate fails on a **regression**, a
+case that fails (or crashes, hangs, or is not supported yet) and is not listed, and on a
+**fixed** case, one listed that passes. With `--known-failing` the run writes no report;
+`docs/kernel-cases.md` stays the full run's.
+
+**Updating a list.** The pull request that changes an outcome changes the list in the same pull
+request, so the list only shrinks and never goes stale:
+
+- a fix (yours, or an SMLib pin bump): remove the line of each case the shard reports as
+ `FIXED`;
+- a new case that fails today: add its line, sorted, with the cause from its result
+ (`results.json` in the shard's `kernel-rig-results-` artifact, or a local run);
+- a regression: fix it in the same pull request.
+
+To check a list locally before pushing: `cargo xtask kernel-cases --area --cli
+target/release/solidcraft-cli --known-failing tests/kernel-cases//KNOWN_FAILING`.
## The complexity ladder
@@ -137,9 +153,17 @@ running part grows one tier at a time through `base`), so the last case carries
```sh
cargo xtask kernel-cases --ladder --cli target/release/solidcraft-cli
+cargo xtask kernel-cases --ladder --cli target/release/solidcraft-cli --gate
cargo xtask kernel-cases --ladder --cli target/release/solidcraft-cli --record "why"
```
+The ladder needs no known-failing list: the golden is the reference. Its shard in the kernel rig
+gate runs with `--gate`, which fails on any case whose status or counts differ from the golden,
+better or worse, and on a case with no golden; times are not compared there (they are the
+machine's). A pull request that changes a ladder result re-records the golden with
+`--record "why the golden changes"` and commits `golden.json` and
+`ladder.json` with it.
+
Ladder runs measure one case at a time (unless `--jobs`) and keep their output in
`target/kernel-ladder` (`--out`); `--record` rewrites the golden and sorts each tier by time,
fastest first; commit both files. The report, `docs/kernel-ladder.md`, gives per tier the counts