Skip to content

Commit 4a51ed2

Browse files
committed
docs(scaffolding): inventory tail — orphan bench tools listed; conformance cadence fixed
- bench/README.md: build_bench.sh / clj_warm_bench.clj / release_metrics.sh get a "occasional-use tools" listing (they were zero-reference orphans). - gate_cadence.md: lib_conformance --all + verify_projects get a fixed re-run cadence (pre-release tag + boundary review chain) so the conformance surfaces cannot silently rot outside the gate. - .dev/README.md: cw_v0_parity_and_gap_plan entry updated to its CLOSED status (retired phase-model wording dropped). Smell-audited: 1: doc-only; closes the 2026-07-02 inventory's remaining quick items
1 parent 3803dbd commit 4a51ed2

3 files changed

Lines changed: 16 additions & 2 deletions

File tree

‎.claude/rules/gate_cadence.md‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -130,6 +130,14 @@ sweep. The "discovery recipe" is the classifier in
130130

131131
## Stale-ness
132132

133+
## Conformance cadence (outside the gate)
134+
135+
`bash scripts/lib_conformance.sh --all` (regenerates
136+
`test/conformance/COVERAGE.md`) and `bash scripts/verify_projects.sh`
137+
run OUTSIDE both gate tiers. Fixed cadence so they cannot silently rot
138+
(2026-07-02): **before any release tag** and **at each boundary review
139+
chain** — plus on demand after a compat-surface campaign lands.
140+
133141
Stale if: the smoke stops being ≤ ~60s or the full gate's e2e-vs-unit
134142
cost asymmetry changes (re-measure); a new shared-risk surface the smoke
135143
core does NOT cover appears (the miss-window grows beyond CLI/REPL/

‎.dev/README.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -16,8 +16,8 @@ Project-level design and operational metadata. Tracked in git. English.
1616
- [`cw_v0_parity_and_gap_plan.md`](./cw_v0_parity_and_gap_plan.md) — the
1717
2026-05-29 cw-v0-vs-cw-v1 parity snapshot + the plan for incorporating
1818
v0's gaps into cw v1 (redesigned, not copied; per-gap ordering +
19-
ROADMAP-amendment hooks). Consulted when opening Phase 15+ / minting
20-
quality-loop rows (ROADMAP §A26). F-003 foresight.
19+
ROADMAP-amendment hooks). CLOSED 2026-07-02 (banner in the file; the
20+
phase model is retired, ADR-0142). Historical reference only.
2121
- [`orbstack_setup.md`](./orbstack_setup.md) — **retired** OrbStack x86_64
2222
gate setup (ADR-0049; kept for history). The live Linux gate is
2323
[`ubuntunote_setup.md`](./ubuntunote_setup.md) + `scripts/run_remote_ubuntu.sh`.

‎bench/README.md‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -24,6 +24,12 @@ bash bench/compare_langs.sh --yaml=bench/cross-lang-latest.yaml
2424

2525
# Regenerate the Markdown table from the YAML
2626
yq -o=json bench/cross-lang-latest.yaml | python3 bench/gen_cross_table.py
27+
28+
# Occasional-use tools (on demand)
29+
bash bench/build_bench.sh # `cljw build` artifact: build time / size / startup
30+
clojure -M bench/clj_warm_bench.clj bench/benchmarks/01_fib_recursive/bench.clj
31+
# warm-JVM comparison for one workload
32+
bash bench/release_metrics.sh # binary-size + startup metrics (RELEASE_METRICS.md)
2733
```
2834

2935
The cross-language harness compiles each language on the fly and auto-skips any

0 commit comments

Comments
 (0)