CLAUDE.md: P0 rule — AdaWorldAPI forks only, never crates.io upstream

Author: claude

CLAUDE.md

@@ -1,5 +1,25 @@
 # CLAUDE.md — lance-graph
 
+## P0 — AdaWorldAPI forks ONLY, NEVER crates.io upstream
+
+**Always depend on the AdaWorldAPI fork of any crate that has one. NEVER use the
+upstream crates.io version of a forked crate.** Non-negotiable; applies to every
+`Cargo.toml` and every dependency decision in this repo. Every repo in this
+workspace is local — prefer the local/fork source over the registry, always.
+
+- Crates with an `AdaWorldAPI/<name>` fork — e.g. `ndarray`, `lance` /
+  `lancedb` / `lance-index` / `lance-linalg` / `lance-namespace`, `surrealdb`,
+  and any other — MUST be wired via the fork (`path` / `git` / `[patch.crates-io]`),
+  never the registry version.
+- If a fork's coordinates (git URL, branch/tag, feature flag) are unknown,
+  **STOP and ask**. Do NOT fall back to crates.io as a convenience or to make a
+  build pass.
+- `"warning: Patch <crate> ... was not used in the crate graph"` means the fork
+  is NOT actually wired — treat it as a build error to fix, never a warning to
+  ignore.
+- crates.io is permitted ONLY for crates that have no AdaWorldAPI fork / no local
+  source.
+
 > **Updated**: 2026-04-21 (categorical-algebraic inference click)
 > **Role**: The obligatory spine — query engine, codec stack, semantic transformer, and orchestration contract
 > **Status**: 22 crates, 7 in workspace, 15 excluded (standalone/DTO), Phases 1-2 DONE, Phases 6-7 DONE (grammar + governance), Phase 3 IN PROGRESS

python/CLAUDE.md

@@ -1,3 +1,11 @@
+## P0 — AdaWorldAPI forks ONLY, NEVER crates.io upstream
+
+**Always depend on the AdaWorldAPI fork of any crate that has one. NEVER use the
+upstream crates.io version of a forked crate.** Non-negotiable; applies to every
+`Cargo.toml` and every dependency decision in this repo. Every repo in this
+workspace is local — prefer the local/fork source over the registry, always.
+If a fork's coordinates are unknown, STOP and ask — never fall back to crates.io.
+
 Use the makefile for most actions:
 
 * Build: `maturin develop`