diff --git a/README.md b/README.md
index 1c8148421..8fa6c6845 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,17 @@
+# Flashbots historic geth-based block builder
+
+This repository contains the historic codebase of the Flashbots geth-based block builder.
+
+This codebase is now deprecated and replaced by https://github.com/flashbots/rbuilder
+
+So long, and thanks for all the fish.
+
+---
+
+The historic README is archived below.
+
+---
+
 [geth readme](README.original.md)
 
 # Flashbots Block Builder