diff --git a/packages/doorman.yaml b/packages/doorman.yaml
index 020916f..8b9f526 100644
--- a/packages/doorman.yaml
+++ b/packages/doorman.yaml
@@ -7,6 +7,7 @@
 # PR gate). The roster is fetched live from the gitea API — NO git
 # mechanics, NO submodule (git_pull add-on lacks submodule support),
 # NO local copy: access-roster remains the single source of truth.
+# Reader/door contract (webhook JSON + unlock endpoint): KNEL/doorman README
 #
 # UNLOCK PATH (founder-approved 2026-09-03): valid badge + the
 # doorman_unlock_enabled input_boolean ON -> rest_command fires the
diff --git a/scenes.yaml b/scenes.yaml
index e69de29..b1ff4b7 100644
--- a/scenes.yaml
+++ b/scenes.yaml
@@ -0,0 +1 @@
+# intentionally empty — scenes are authored in the HA UI if ever needed
diff --git a/scripts.yaml b/scripts.yaml
index e69de29..c05cdfc 100644
--- a/scripts.yaml
+++ b/scripts.yaml
@@ -0,0 +1 @@
+# intentionally empty — scripts are authored in the HA UI if ever needed
diff --git a/themes/.gitkeep b/themes/.gitkeep
new file mode 100644
index 0000000..2b6133e
--- /dev/null
+++ b/themes/.gitkeep
@@ -0,0 +1,2 @@
+# intentional placeholder: themes dir must exist for the
+# !include_dir_merge_named in configuration.yaml [#784 gardening]