diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 000000000..3e772d037
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,10 @@
+# Vite Task
+
+Build, test, lint and format commands, as defined in `justfile`:
+
+- Type-check the workspace: `just check`
+- Run the tests: `just test`
+- Run clippy with warnings denied: `just lint`
+- Format Rust and other files: `just fmt`
+- Build the docs with warnings denied: `just doc`
+- Run the full local check sequence before pushing: `just ready`