diff --git a/docs/api/.gitkeep b/docs/api/.gitkeep
index e69de29..94f7de9 100644
--- a/docs/api/.gitkeep
+++ b/docs/api/.gitkeep
@@ -0,0 +1 @@
+# placeholder — remove when first file is added
diff --git a/docs/architecture/.gitkeep b/docs/architecture/.gitkeep
index e69de29..94f7de9 100644
--- a/docs/architecture/.gitkeep
+++ b/docs/architecture/.gitkeep
@@ -0,0 +1 @@
+# placeholder — remove when first file is added
diff --git a/docs/assets/.gitkeep b/docs/assets/.gitkeep
index e69de29..94f7de9 100644
--- a/docs/assets/.gitkeep
+++ b/docs/assets/.gitkeep
@@ -0,0 +1 @@
+# placeholder — remove when first file is added
diff --git a/docs/backlog/.gitkeep b/docs/backlog/.gitkeep
index e69de29..94f7de9 100644
--- a/docs/backlog/.gitkeep
+++ b/docs/backlog/.gitkeep
@@ -0,0 +1 @@
+# placeholder — remove when first file is added
diff --git a/docs/decisions/.gitkeep b/docs/decisions/.gitkeep
index e69de29..94f7de9 100644
--- a/docs/decisions/.gitkeep
+++ b/docs/decisions/.gitkeep
@@ -0,0 +1 @@
+# placeholder — remove when first file is added
diff --git a/docs/design/.gitkeep b/docs/design/.gitkeep
index e69de29..94f7de9 100644
--- a/docs/design/.gitkeep
+++ b/docs/design/.gitkeep
@@ -0,0 +1 @@
+# placeholder — remove when first file is added
diff --git a/docs/qa/.gitkeep b/docs/qa/.gitkeep
index e69de29..94f7de9 100644
--- a/docs/qa/.gitkeep
+++ b/docs/qa/.gitkeep
@@ -0,0 +1 @@
+# placeholder — remove when first file is added
diff --git a/docs/runbooks/.gitkeep b/docs/runbooks/.gitkeep
index e69de29..94f7de9 100644
--- a/docs/runbooks/.gitkeep
+++ b/docs/runbooks/.gitkeep
@@ -0,0 +1 @@
+# placeholder — remove when first file is added
diff --git a/docs/specs/.gitkeep b/docs/specs/.gitkeep
index e69de29..94f7de9 100644
--- a/docs/specs/.gitkeep
+++ 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
index e69de29..94f7de9 100644
--- a/docs/specs/dialogs/.gitkeep
+++ b/docs/specs/dialogs/.gitkeep
@@ -0,0 +1 @@
+# placeholder — remove when first file is added