diff --git a/spring-boot/shared/README.md b/spring-boot/shared/README.md
new file mode 100644
index 0000000..05d69d2
--- /dev/null
+++ b/spring-boot/shared/README.md
@@ -0,0 +1,4 @@
+# cqrs4j-spring-example-shared
+Code shared between Spring Boot command and query microservice.
+
+> :warning: Normally you should **not** share code this way between your command and query microservices. A shared-nothing approach is a good practice for microservices (See for example [Don't Share Libraries among Microservices](https://phauer.com/2016/dont-share-libraries-among-microservices/)). You can simply copy the content of this module directly into your command and projects.