diff --git a/design/diagrams/README.md b/design/diagrams/README.md
new file mode 100644
index 0000000..a13b220
--- /dev/null
+++ b/design/diagrams/README.md
@@ -0,0 +1,4 @@
+# Diagrams (optional)
+
+Place architecture diagrams (mermaid sources or images) here when useful.
+Design narrative lives in sibling markdown files.