From 0d662e9f38ee9348c4aedce21783357d9daed693 Mon Sep 17 00:00:00 2001
From: Stuart Axelbrooke <stuart@axelbrooke.com>
Date: Sat, 26 Jul 2025 23:28:39 -0700
Subject: [PATCH] Tell claude more forcefully to use the databuild.proto
 interfaces

---
 CLAUDE.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/CLAUDE.md b/CLAUDE.md
index 3287b1f..fb46db0 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -90,6 +90,7 @@ def lookup_job_for_partition(partition_ref: str) -> str:
 ```
 
 ### Common Pitfalls
+- **Not using protobuf-defined interface**: Where structs and interfaces are defined centrally in [`databuild.proto`](./databuild/databuild.proto), those interfaces should always be used. E.g., in rust depending on them via the prost-generated structs, and in the web app via the OpenAPI-generated typescript interfaces.
 - **Empty args**: Jobs with `"args": []` won't execute properly
 - **Wrong target refs**: Job lookup must return base targets, not `.cfg` variants
 - **Missing partition refs**: All outputs must be addressable via partition references