From 88c783a278ef77b8c525ca32d546a7b7228e7170 Mon Sep 17 00:00:00 2001
From: rob <robdickson444@hotmail.com>
Date: Sat, 1 Nov 2025 14:34:43 -0300
Subject: [PATCH] docs: add shared ai configuration scaffold

---
 config/ai.yml | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)
 create mode 100644 config/ai.yml

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: []