diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..b53b8cc
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,22 @@
+# Schala Development Guide
+
+## Build & Test Commands
+- Build: `cargo build`
+- Run: `cargo run`
+- Release build: `cargo build --release`
+- Test all: `cargo test`
+- Test single: `cargo test test_name`
+- Lint: `cargo clippy`
+- Format: `cargo fmt`
+
+## Code Style Guidelines
+- **Edition**: Rust 2021
+- **Naming**: Snake case for functions/variables, CamelCase for types/traits
+- **Imports**: Group standard library, external crates, then internal modules
+- **Error Handling**: Use Result type for recoverable errors, panic for unrecoverable ones
+- **Formatting**: Follow rustfmt defaults (4-space indentation)
+- **Comments**: Document public APIs with /// comments
+- **Types**: Prefer strong typing, avoid `unwrap()` in production code
+
+## Project Info
+- Language implementation with Python-like syntax but no runtime value errors
\ No newline at end of file