diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..b92e370
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,28 @@
+# Claude Instructions
+
+## Project Overview
+DataBuild is a bazel-based data build system. Key files:
+- [`databuild.proto`](databuild/databuild.proto) - System interfaces
+- [`manifesto.md`](manifesto.md) - Project philosophy
+- [`core-concepts.md`](core-concepts.md) - Core concepts
+
+## Build & Test
+```bash
+# Run all tests
+./scripts/bb_test_all
+
+# Remote testing
+./scripts/bb_remote_test_all
+
+# Do not try to `bazel test //examples/basic_graph/...`, as this will not work.
+```
+
+## Project Structure
+- `databuild/` - Core system (Rust/Proto)
+- `examples/` - Example implementations
+- `scripts/` - Build utilities
+
+## Key Components
+- Graph analysis/execution in Rust
+- Bazel rules for job orchestration
+- Java/Python examples for different use cases
\ No newline at end of file