diff --git a/config/ai.yml b/config/ai.yml
new file mode 100644
index 0000000..ab7a528
--- /dev/null
+++ b/config/ai.yml
@@ -0,0 +1,30 @@
+# CascadingDev AI configuration (v1)
+#
+# This repository (CascadingDev tooling) uses this file to coordinate AI
+# command preferences across the automation runner, Ramble GUI, and other
+# helper scripts. Values are copied into generated projects so end users can
+# customise their preferred providers without editing source code.
+#
+# Command chains are evaluated left → right until a tool succeeds. Use the
+# literal token "||" to separate commands in overrides, but each entry here is
+# declared individually for readability.
+#
+# The sentinel token tells automation that "no changes" is intentional and
+# should not be treated as an error.
+
+version: 1
+
+runner:
+  command_chain:
+    - "claude -p"
+  sentinel: "CASCADINGDEV_NO_CHANGES"
+
+ramble:
+  default_provider: mock
+  providers:
+    mock:
+      kind: mock
+    claude_cli:
+      kind: claude_cli
+      command: "claude"
+      args: []