ci: pin every workflow to Zig 0.15.2

.github/workflows/agent-decompose.yml

@@ -51,7 +51,7 @@ jobs:
       - name: Setup Zig
         uses: goto-bus-stop/setup-zig@v2
         with:
-          version: 0.15.0-dev
+          version: 0.15.2-dev
 
       - name: Build tri CLI
         run: zig build

.github/workflows/build-compiler-release.yml

@@ -13,7 +13,7 @@ on:
   workflow_dispatch:
 
 env:
-  ZIG_VERSION: '0.13.0'
+  ZIG_VERSION: '0.15.2'
 
 jobs:
   build-linux:

.github/workflows/docs-check.yml

@@ -101,7 +101,7 @@ jobs:
       - name: Install Zig
         uses: goto-bus-stop/setup-zig@v2
         with:
-          version: 0.15.0
+          version: 0.15.2
 
       - name: Build tri CLI
         run: |

.github/workflows/extension-release.yml

@@ -40,7 +40,7 @@ jobs:
       - name: Setup Zig
         uses: goto-bus-stop/setup-zig@v2
         with:
-          version: 0.13.0
+          version: 0.15.2
 
       - name: Setup Node.js
         uses: actions/setup-node@v4

.github/workflows/extension-tests.yml

@@ -27,7 +27,7 @@ jobs:
       - name: Setup Zig
         uses: goto-bus-stop/setup-zig@v2
         with:
-          version: 0.13.0
+          version: 0.15.2
 
       - name: Build WASM
         run: |

.github/workflows/nexus-build.yml

@@ -23,7 +23,7 @@ jobs:
       - name: Setup Zig
         uses: goto-bus-stop/setup-zig@v2
         with:
-          version: 0.15.0
+          version: 0.15.2
 
       - name: Build ${{ matrix.module }}
         working-directory: trinity-nexus
@@ -42,7 +42,7 @@ jobs:
       - name: Setup Zig
         uses: goto-bus-stop/setup-zig@v2
         with:
-          version: 0.15.0
+          version: 0.15.2
 
       - name: Build all modules
         working-directory: trinity-nexus

.github/workflows/record-demos.yml

@@ -18,7 +18,7 @@ jobs:
       - name: Install Zig
         uses: goto-bus/setup-zig@v2
         with:
-          version: 0.15.0
+          version: 0.15.2
 
       - name: Install VHS
         run: |

CLAUDE.md

@@ -1,5 +1,22 @@
 # CLAUDE.md
 
+## Pinned Zig version — 0.15.2
+
+**Every workflow uses `0.15.2`.** Before 2026-08-10 they did not: 22 places said 0.15.2,
+five said 0.15.0, and three that actually run `zig build` — `build-compiler-release.yml`,
+`extension-tests.yml`, `extension-release.yml` — said 0.13.0, two majors behind.
+
+This document previously carried migration rules for 0.14 and 0.15 at once, which is how a
+reader ends up applying the wrong one.
+
+**A locally installed Zig is not the CI toolchain.** On 0.16 a clean checkout of `main`
+fails at `build.zig:67` with `no field or member function named 'linkLibC'` — an error CI
+never sees, because `linkLibC` still exists in 0.15. A green local build proves nothing
+about CI, and a red one says nothing about your change. Match 0.15.2 locally before drawing
+any conclusion from a build.
+
+---
+
 ## Zig 0.15 API Compatibility and Migration Rules
 
 **Reference**: docs/zig-migration-rules.md — https://ziglang.org/download/0.15.1/