diff --git a/deploy/compose/README.md b/deploy/compose/README.md
new file mode 100644
index 0000000..6b8f5e1
--- /dev/null
+++ b/deploy/compose/README.md
@@ -0,0 +1,5 @@
+# Compose (scaffold)
+
+**Status:** No `docker-compose.yml` until **build**.
+
+Will host gateway/sandbox alignment, local QBO MCP, webhooks, volumes — per [design/DESIGN_PLAN.md](../../design/DESIGN_PLAN.md).