diff --git a/docs/api/.gitkeep b/docs/api/.gitkeep
new file mode 100644
index 0000000..94f7de9
--- /dev/null
+++ b/docs/api/.gitkeep
@@ -0,0 +1 @@
+# placeholder — remove when first file is added
diff --git a/docs/architecture/.gitkeep b/docs/architecture/.gitkeep
new file mode 100644
index 0000000..94f7de9
--- /dev/null
+++ b/docs/architecture/.gitkeep
@@ -0,0 +1 @@
+# placeholder — remove when first file is added
diff --git a/docs/assets/.gitkeep b/docs/assets/.gitkeep
new file mode 100644
index 0000000..94f7de9
--- /dev/null
+++ b/docs/assets/.gitkeep
@@ -0,0 +1 @@
+# placeholder — remove when first file is added
diff --git a/docs/backlog/.gitkeep b/docs/backlog/.gitkeep
new file mode 100644
index 0000000..94f7de9
--- /dev/null
+++ b/docs/backlog/.gitkeep
@@ -0,0 +1 @@
+# placeholder — remove when first file is added
diff --git a/docs/decisions/.gitkeep b/docs/decisions/.gitkeep
new file mode 100644
index 0000000..94f7de9
--- /dev/null
+++ b/docs/decisions/.gitkeep
@@ -0,0 +1 @@
+# placeholder — remove when first file is added
diff --git a/docs/design/.gitkeep b/docs/design/.gitkeep
new file mode 100644
index 0000000..94f7de9
--- /dev/null
+++ b/docs/design/.gitkeep
@@ -0,0 +1 @@
+# placeholder — remove when first file is added
diff --git a/docs/qa/.gitkeep b/docs/qa/.gitkeep
new file mode 100644
index 0000000..94f7de9
--- /dev/null
+++ b/docs/qa/.gitkeep
@@ -0,0 +1 @@
+# placeholder — remove when first file is added
diff --git a/docs/runbooks/.gitkeep b/docs/runbooks/.gitkeep
new file mode 100644
index 0000000..94f7de9
--- /dev/null
+++ b/docs/runbooks/.gitkeep
@@ -0,0 +1 @@
+# placeholder — remove when first file is added
diff --git a/docs/specs/.gitkeep b/docs/specs/.gitkeep
new file mode 100644
index 0000000..94f7de9
--- /dev/null
+++ b/docs/specs/.gitkeep
@@ -0,0 +1 @@
+# placeholder — remove when first file is added
diff --git a/docs/specs/dialogs/.gitkeep b/docs/specs/dialogs/.gitkeep
new file mode 100644
index 0000000..94f7de9
--- /dev/null
+++ b/docs/specs/dialogs/.gitkeep
@@ -0,0 +1 @@
+# placeholder — remove when first file is added