diff --git a/.github/workflows/README.md b/.github/workflows/README.md
new file mode 100644
index 0000000..085b9d5
--- /dev/null
+++ b/.github/workflows/README.md
@@ -0,0 +1,5 @@
+# CI workflows (scaffold)
+
+**Status:** No workflow YAML until **build** (optional docs-only CI later).
+
+Intended: lint docs, unit tests on fixtures, no live SaaS credentials in CI.