diff --git a/.coderabbit.yaml b/.coderabbit.yaml
new file mode 100644
index 000000000..5edeebe05
--- /dev/null
+++ b/.coderabbit.yaml
@@ -0,0 +1,12 @@
+inheritance: true
+knowledge_base:
+  linked_repositories:
+    - repository: 'codeready-toolchain/toolchain-common'
+      instructions: >
+        toolchain-common contains shared controllers, utilities, and libraries used by toolchain-e2e.
+
+        When reviewing toolchain-e2e changes:
+        - Check if toolchain-e2e is using deprecated or outdated patterns from toolchain-common when newer/better utilities exist.
+        - Verify behavioral assumptions — if toolchain-e2e expects specific return values or side effects from toolchain-common functions, check if that behavior is actually implemented.
+        - If toolchain-e2e duplicates logic that already exists in toolchain-common (pkg/cluster, pkg/condition, pkg/configuration, pkg/status), suggest using the shared implementation instead.
+        - Flag if toolchain-e2e is making assumptions about toolchain-common's internal state or behavior that isn't documented or guaranteed.