diff --git a/caddy/meta/argument_specs.yml b/caddy/meta/argument_specs.yml
new file mode 100644
index 0000000000000000000000000000000000000000..38e7a7a7baa252b3fa4fab63795ef9077a4e04ab
--- /dev/null
+++ b/caddy/meta/argument_specs.yml
@@ -0,0 +1,30 @@
+---
+
+argument_specs:
+  main:
+    short_description: Install and configure Caddy web server
+    description:
+      - >-
+        This is the main entry point for this role.  It is a prerequisite of the
+        C(caddy) entry point.
+      - The C(main) entry point is designed to be used in a playbook.
+    options:
+      caddy_global:
+        type: dict
+        required: false
+        description:
+          - Global caddy options.  Maps directly to Caddyfile.
+          - >-
+            See L(upstream
+            documentation,https://caddyserver.com/docs/caddyfile/options) for
+            details.
+          - |
+            Example::
+
+              caddy_global:
+                auto_https: false
+                email: acme@example.org
+                on_demand_tls:
+                  ask: http://localhost:9123/ask
+                debug: ""  # Special value-less option, use with empty string
+                http_port: null  # Omit, useful to override in more specific variables