diff --git a/README.md b/README.md
index ed2bfcce..e44d7034 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,9 @@
 # ipfs-cluster
+
+THIS README IS A STUB. you can help by expanding it.
+
 main repo for ipfs-cluster tooling
+
+
+- old ipfs-cluster design notes https://github.com/ipfs/notes/issues/58
+