diff --git a/boot/flyway/README.adoc b/boot/flyway/README.adoc
new file mode 100644
index 0000000..908b1d6
--- /dev/null
+++ b/boot/flyway/README.adoc
@@ -0,0 +1,9 @@
+Document lifecycle requirements with Flyway.
+
+== Lifecycle configuration guidance
+
+Flyway requires extra configuration to avoid early database interaction.
+
+```
+spring.flyway.enabled=false
+```