Skip to content

Commit 582d74d

Browse files
docs(performance): single-source the gate composition
Three documents carried hand-maintained copies of the verify-performance composition, and two had already drifted from the recipes. ci-policy.md is now the one prose description (preflight.md points there; the justfile stays the executable source of truth). validation-summary.md — an unreferenced work-item summary whose gate list was the stalest copy — and incremental-fastest-delta.md — by its own header a point-in-time projection of the authoritative FPE-GAP catalog that loses to it on every disagreement — are removed; the README index names the catalog as the single delta ledger.
1 parent b735e6b commit 582d74d

4 files changed

Lines changed: 7 additions & 280 deletions

File tree

docs/performance/README.md

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -14,10 +14,9 @@ fixtures, and performance gate contracts.
1414
behavior.
1515
- [Known gaps](known-gaps.md): performance gaps that remain intentionally open.
1616
- [Fastest-engine known gaps](fastest-engine-known-gaps.md): the `FPE-GAP-*`
17-
catalog of remaining fastest-engine deltas and their closure requirements.
18-
- [Incremental fastest-engine delta guard](incremental-fastest-delta.md):
19-
current-`main` present/partial/report-only/absent classification and the
20-
smallest remaining deltas, to stop reimplementation of existing features.
17+
catalog of remaining fastest-engine deltas and their closure requirements —
18+
the single authoritative delta ledger (point-in-time projections of it are
19+
not committed; they drift).
2120

2221
## Optimization Areas
2322

docs/performance/incremental-fastest-delta.md

Lines changed: 0 additions & 126 deletions
This file was deleted.

docs/performance/preflight.md

Lines changed: 4 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -31,27 +31,10 @@ Use the aggregate performance gate for performance-related changes:
3131
nix develop -c just verify-performance
3232
```
3333

34-
The gate includes:
35-
36-
- `performance-tests`
37-
- `performance-regression` (includes the `perf-flag-matrix` A/B matrix)
38-
- `cache-roundtrip`
39-
- `optimizer-diff`
40-
- `quickening-smoke`
41-
- `inline-cache-smoke`
42-
- `jit-smoke`
43-
- `safety-audit-smoke`
44-
- `benchmark-smoke`
45-
- `framework-smoke`
46-
47-
The release-profile and report gates run as `verify-performance-extended`
48-
(its own job in the CI gate matrix):
49-
50-
- `release-benchmark-smoke`
51-
- `callgrind-smoke`
52-
- `hotpath-inventory`
53-
- `fastest-hotpath-report`
54-
- `perf-report`
34+
The gate composition (and the split into `verify-performance` and
35+
`verify-performance-extended`) is documented once, in
36+
[`ci-policy.md`](ci-policy.md); the `justfile` recipes are the executable
37+
source of truth.
5538

5639
Long benchmark suites remain opt-in and are not default pull-request gates:
5740

0 commit comments

Comments
 (0)