diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..b2b29e7
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,26 @@
+# Claude Instructions
+
+## Project Overview
+DataBuild is a bazel-based data build system. Key files:
+- `databuild.proto` - System interfaces
+- `manifesto.md` - Project philosophy
+- `core-concepts.md` - Core concepts
+
+## Build & Test
+```bash
+# Run all tests
+./scripts/bb_test_all
+
+# Remote testing
+./scripts/bb_remote_test_all
+```
+
+## 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