diff --git a/android/config/detekt.yml b/android/config/detekt.yml
index fa88c3cf..ae90ff9b 100644
--- a/android/config/detekt.yml
+++ b/android/config/detekt.yml
@@ -1,3 +1,10 @@
-# Minimal detekt config. Default rules apply via `buildUponDefaultConfig`.
-build:
-  maxIssues: 0
+# Empty detekt config — relies on defaults via `buildUponDefaultConfig = true`
+# in the :app detekt {} block. Per-rule overrides go here as needed:
+#
+#   style:
+#     MagicNumber:
+#       active: false
+#
+# The pre-2.0 `build: maxIssues: 0` top-level was removed; failure
+# threshold is configured via the Gradle DSL's `failOnSeverity` option
+# instead (defaults to Error).