diff --git a/CLAUDE.md b/CLAUDE.md
index 196fc23..869bf7b 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -130,6 +130,7 @@ def lookup_job_for_partition(partition_ref: str) -> str:
 - **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
+- **Not adding new generated files to OpenAPI outs**: Bazel hermeticity demands that we specify each output file, so when the OpenAPI code gen would create new files, we need to explicitly add them to the target's outs field.
 
 ## Documentation