Skip to content

Commit 574bfe8

Browse files
committed
docs(claude-md): prune dead and aspirational language entries
Remove languages declared in the allowed list but with zero files on disk (Tauri, Dioxus, Gleam, Ada) and the mobile development section that anchored them. Retain OCaml as "AffineScript / Ephapax compiler host (planned)" and Nickel as "planned" pending compiler-choice and config-wiring decisions. Add rows for languages that are actually pulling weight but were not explicitly listed: Idris2 (ABI proofs), Agda (meta-checker), Zig (Rust<->Chapel FFI), Chapel (parallel dispatch). Reflect Rust and Julia as core implementation languages rather than "performance- critical" and "batch". Trim the banned table and enforcement rules to match — mobile- specific bans (Kotlin/Swift/React Native/Flutter) are no longer relevant once Tauri/Dioxus are removed.
1 parent f18d85f commit 574bfe8

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)