Skip to content

Commit 64a8345

Browse files
Refactor language/tool stack documentation for Rust-first architecture
2 parents 050de1e + 574bfe8 commit 64a8345

1 file changed

Lines changed: 16 additions & 32 deletions

File tree

.claude/CLAUDE.md

Lines changed: 16 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -99,53 +99,37 @@ package definitions (not metadata files) and must NOT be deleted.
9999

100100
| Language/Tool | Use Case | Notes |
101101
|---------------|----------|-------|
102-
| **ReScript** | Primary application code | Compiles to JS, type-safe |
103-
| **Deno** | Runtime & package management | Replaces Node/npm/bun |
104-
| **Rust** | Performance-critical, systems, WASM | Preferred for CLI tools |
105-
| **Tauri 2.0+** | Mobile apps (iOS/Android) | Rust backend + web UI |
106-
| **Dioxus** | Mobile apps (native UI) | Pure Rust, React-like |
107-
| **Gleam** | Backend services | Runs on BEAM or compiles to JS |
108-
| **Bash/POSIX Shell** | Scripts, automation | Keep minimal |
109-
| **JavaScript** | Only where ReScript cannot | MCP protocol glue, Deno APIs |
110-
| **Nickel** | Configuration language | For complex configs |
111-
| **Guile Scheme** | State/meta files | .machine_readable/6a2/STATE.a2ml, .machine_readable/6a2/META.a2ml, .machine_readable/6a2/ECOSYSTEM.a2ml |
112-
| **Julia** | Batch scripts, data processing | Per RSR |
113-
| **OCaml** | AffineScript compiler | Language-specific |
114-
| **Ada** | Safety-critical systems | Where required |
102+
| **Rust** | Core systems, prover backends, trust pipeline, CLI, WASM | Primary implementation language |
103+
| **Julia** | ML inference, batch data processing, extract scripts | Per RSR |
104+
| **Idris2** | ABI formal proofs (zero `believe_me`) | `src/abi/` — 16 modules, constructive |
105+
| **Agda** | Trust-pipeline meta-checker proofs | `proofs/agda/` |
106+
| **Zig** | FFI shim between Rust and Chapel | `src/zig_ffi/` |
107+
| **Chapel** | Optional parallel proof dispatch | Wired via Cargo `chapel` feature |
108+
| **Guile Scheme** | Guix package definitions (`guix.scm`, `manifests/*.scm`) | `.scm` metadata files are deprecated — see below |
109+
| **Bash/POSIX Shell** | Build scripts, CI glue | Keep minimal |
110+
| **ReScript** | UI components (compiled to JS, served via Deno) | `src/rescript/` |
111+
| **Deno** | Runtime for compiled ReScript UI | Replaces Node/npm/bun |
112+
| **JavaScript** | Build tooling only (Tailwind config, test harness) | Not for business logic |
113+
| **OCaml** | AffineScript / Ephapax compiler host (planned) | No files yet — retain pending source-language decision |
114+
| **Nickel** | Configuration language (planned) | `.k9.ncl` scaffold exists but not yet wired |
115115

116116
### BANNED - Do Not Use
117117

118118
| Banned | Replacement |
119119
|--------|-------------|
120120
| TypeScript | ReScript |
121121
| Node.js | Deno |
122-
| npm | Deno |
123-
| Bun | Deno |
124-
| pnpm/yarn | Deno |
122+
| npm / Bun / pnpm / yarn | Deno |
125123
| Go | Rust |
126-
| Python | Julia/Rust/ReScript |
127-
| Java/Kotlin | Rust/Tauri/Dioxus |
128-
| Swift | Tauri/Dioxus |
129-
| React Native | Tauri/Dioxus |
130-
| Flutter/Dart | Tauri/Dioxus |
131-
132-
### Mobile Development
133-
134-
**No exceptions for Kotlin/Swift** - use Rust-first approach:
135-
136-
1. **Tauri 2.0+** - Web UI (ReScript) + Rust backend, MIT/Apache-2.0
137-
2. **Dioxus** - Pure Rust native UI, MIT/Apache-2.0
138-
139-
Both are FOSS with independent governance (no Big Tech).
124+
| Python | Julia / Rust |
140125

141126
### Enforcement Rules
142127

143128
1. **No new TypeScript files** - Convert existing TS to ReScript
144129
2. **No package.json for runtime deps** - Use deno.json imports
145130
3. **No node_modules in production** - Deno caches deps automatically
146131
4. **No Go code** - Use Rust instead
147-
5. **No Python anywhere** - Use Julia for data/batch, Rust for systems, ReScript for apps
148-
6. **No Kotlin/Swift for mobile** - Use Tauri 2.0+ or Dioxus
132+
5. **No Python anywhere** - Use Julia for data/batch, Rust for systems
149133

150134
### Package Management
151135

0 commit comments

Comments
 (0)