diff --git a/README.md b/README.md
index cd4c072..d250d61 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,9 @@
+# Deprecation notice
+
+⚠️ The present reference architecture implementation for AWS has been deprecated. It will continue to be available at this location for some time, but not receive further updates.
+
+The deprecation only affects the reference implementation contained in this repository, not the underlying conceptual architectures and supplementary materials shown on the [Humanitec website](https://humanitec.com/reference-architectures).
+
 # Humanitec AWS Reference Architecture
 
 > TL;DR