diff --git a/.coderabbit.yaml b/.coderabbit.yaml
new file mode 100644
index 0000000..0151685
--- /dev/null
+++ b/.coderabbit.yaml
@@ -0,0 +1,31 @@
+# yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json
+language: en-US
+
+reviews:
+  profile: chill
+  request_changes_workflow: false
+  poem: false
+  collapse_walkthrough: true
+  auto_review:
+    enabled: true
+    drafts: false
+    auto_incremental_review: true
+    base_branches:
+      - main
+  path_filters:
+    - "!**/target/**"
+  path_instructions:
+    - path: "pom.xml"
+      instructions: >-
+        Shared Maven parent POM; dependency, plugin, and property version changes here cascade
+        to all child modules (core, spring-boot). Call out major or potentially-breaking bumps
+        and any change to <dependencyManagement>/<pluginManagement> defaults downstream relies on.
+  tools:
+    gitleaks:
+      enabled: true
+    actionlint:
+      enabled: true
+
+knowledge_base:
+  learnings:
+    scope: auto