docs: clarify prerequisites are for development only

- Add note about pre-built binaries not yet available
- Explain what each tool (Rust, Bun) is for
- Clarify that users write TypeScript, not Lua
- Update docs/development.md with current project structure

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: pterror

README.md

@@ -45,10 +45,14 @@ The project is organized as a monorepo with Rust backend and TypeScript frontend
 
 ## Getting Started
 
-### Prerequisites
+> **Note**: Pre-built binaries are not yet available. For now, you'll need to build from source.
 
-- [Rust](https://rustup.rs/) (latest stable)
-- [Bun](https://bun.sh/) (v1.0.0 or later)
+### Prerequisites (Development)
+
+- [Rust](https://rustup.rs/) (latest stable) — builds the server and game engine
+- [Bun](https://bun.sh/) (v1.0.0+) — builds the web/TUI/Discord clients
+
+Scripts are written in TypeScript and compile down to Lua internally — you don't need to know Lua.
 
 ### Installation
 

docs/development.md

@@ -2,11 +2,16 @@
 
 Welcome to the Lotus development guide! This document will help you get set up and contributing to the project.
 
+> **Note**: Pre-built binaries are not yet available. These prerequisites are for building from source.
+
 ## Getting Started
 
 ### Prerequisites
 
-- **[Bun](https://bun.sh/)**: Lotus is built on the Bun runtime. Ensure you have the latest version installed.
+- **[Rust](https://rustup.rs/)** (latest stable) — builds the server and game engine
+- **[Bun](https://bun.sh/)** (v1.0.0+) — builds the web/TUI/Discord clients
+
+Scripts are written in TypeScript and compile down to Lua internally — you don't need to know Lua.
 
 ### Installation
 
@@ -17,41 +22,53 @@ Welcome to the Lotus development guide! This document will help you get set up a
     cd lotus
     ```
 
-2.  Install dependencies:
+2.  Install TypeScript dependencies:
     ```bash
     bun install
     ```
 
+3.  Build Rust backend:
+    ```bash
+    cargo build --release
+    ```
+
 ### Project Structure
 
-Lotus is a monorepo managed by Bun workspaces.
-
-- **`apps/`**: Deployable applications.
-  - `server`: The core game server.
-  - `web`: The web frontend.
-  - `cli`: The terminal client.
-  - `discord-bot`: The Discord integration.
-- **`packages/`**: Shared libraries.
-  - `core`: The game engine logic.
-  - `scripting`: The Reed compiler and interpreter.
-  - `client`: The TypeScript SDK.
-  - `shared`: Shared types and utilities.
-- **`plugins/`**: Optional game features.
-  - `ai`: LLM integration.
-  - `memory`: Vector memory system.
+Lotus is a monorepo with Rust backend (`crates/`) and TypeScript frontends (`apps/`, `packages/`).
+
+#### Rust Crates (`crates/`)
+
+- `lotus-ir`: S-expression types and validation
+- `lotus-core`: Entity system, capabilities, SQLite storage
+- `lotus-runtime`: Script execution with LuaJIT
+- `lotus-cli`: CLI binary
+- `syntax/typescript`: TypeScript → S-expression transpiler
+- `runtime/luajit`: S-expression → Lua codegen
+- `transport/websocket-jsonrpc`: WebSocket server
+- `plugins/*`: Native plugins (ai, fs, net, sqlite, procgen, vector, memory)
+- `apps/notes-server`: Notes app server
+- `apps/filebrowser-server`: File browser app server
+
+#### TypeScript (`apps/`, `packages/`)
+
+- **`apps/`**: Frontend applications
+  - `web`: Main web frontend (SolidJS)
+  - `tui`: Terminal user interface
+  - `discord-bot`: Discord integration
+  - `notes`: Wiki-style notes client
+  - `filebrowser`: File browser client
+- **`packages/`**: Shared libraries
+  - `client`: WebSocket client SDK
+  - `shared`: Shared types (JSON-RPC protocol)
 
 ### Running Tests
 
-To run tests across the entire workspace:
-
 ```bash
-bun test
-```
-
-To run tests for a specific package:
+# Rust tests
+cargo test --workspace
 
-```bash
-bun test --filter @lotus/core
+# TypeScript tests
+bun test
 ```
 
 ## Building the Documentation