diff --git a/.claude/CLAUDE.md b/.claude/CLAUDE.md
index 941efbb..2bd1e9d 100644
--- a/.claude/CLAUDE.md
+++ b/.claude/CLAUDE.md
@@ -114,8 +114,8 @@ LithClient.exists_by_hash?("evidence", sha256_hash)
 | Language/Tool | Use Case | Notes |
 |---------------|----------|-------|
 | **Elixir** | This project's primary language | Phoenix, LiveView, Absinthe |
-| **AffineScript** | Primary application code | Affine-typed, compiles to typed-wasm or Deno-ESM |
-| **Deno** | Runtime & package management | Replaces Node/npm/bun |
+| **AffineScript** | Primary application code | Affine-typed, compiles to typed-wasm or ESM |
+| **Bun** | JS runtime & package management (tier 1) | Default for all new work. Runs compiled ESM/JS directly — no bundler step. Uses an npm-compatible `package.json` plus `bun.lock` — both are expected, not anti-patterns. |
 | **Rust** | Performance-critical, systems, WASM | Preferred for CLI tools |
 | **Gleam** | Backend services | Runs on BEAM or compiles to JS |
 | **Bash/POSIX Shell** | Scripts, automation | Keep minimal |
@@ -127,8 +127,10 @@ LithClient.exists_by_hash?("evidence", sha256_hash)
 | Banned | Replacement |
 |--------|-------------|
 | TypeScript | AffineScript |
-| Node.js | Deno |
-| npm/Bun/pnpm/yarn | Deno |
+| ReScript | AffineScript |
+| Deno | Bun |
+| Node.js | Bun |
+| npm/pnpm/yarn | Bun |
 | Go | Rust |
 | Python | Julia/Rust/AffineScript |
 | Java/Kotlin | Rust |