diff --git a/.coderabbit.yaml b/.coderabbit.yaml
new file mode 100644
index 00000000000..0d3213f33b5
--- /dev/null
+++ b/.coderabbit.yaml
@@ -0,0 +1,14 @@
+# yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json
+
+tone_instructions: |
+  You are a concise code reviewer. Focus only on critical logic, security, and performance issues. 
+  Avoid trivial style issues or minor formatting suggestions.
+
+reviews:
+  path_instructions:
+    - path: ".rebase/CHANGELOG.md"
+      instructions: "Ignore markdownlint rule MD001 (heading-increment). The `####` heading style is intentional and consistent throughout this file."
+  # 'chill' is less verbose, 'assertive' is more verbose
+  profile: chill
+  # disable poem generation in comments
+  poem: false