diff --git a/README.md b/README.md
index 9af38d74e..396293769 100644
--- a/README.md
+++ b/README.md
@@ -15,6 +15,20 @@ Some day we will hopefully transform these specs into RFCs. For now, they assume
 
 - [Work In Progress](#work-in-progress)
 - [Specs](#specs)
+  - [High level Architecture of IPFS](/architecture)
+  - [bitswap](/bitswap)
+  - [DEX - Importers and Exporters](/dex)
+  - [Files API and MFS](/files)
+    - [Unixfs](/unixfs)
+  - [IPRS](/iprs)
+  - [keychain](/keychain)
+  - [keystore](/keystore)
+  - [MerkleDAG (deprecated, see IPLD)](/merkledag)
+  - [Repo](/repo)
+  - [Public API (CLI, HTTP and Core)](/public-api)
+  - [Protocol Driven Development](/pdd)
+  - [IPLD](https://github.com/ipld/specs)
+  - [libp2p](https://github.com/libp2p/specs)
 - [Contribute](#contribute)
 - [License](#license)
 
diff --git a/iprs-interplanetary-record-system/README.md b/iprs/README.md
similarity index 100%
rename from iprs-interplanetary-record-system/README.md
rename to iprs/README.md
diff --git a/pdd-protocol-driven-development/PDD-multistream.md b/pdd/PDD-multistream.md
similarity index 100%
rename from pdd-protocol-driven-development/PDD-multistream.md
rename to pdd/PDD-multistream.md
diff --git a/pdd-protocol-driven-development/README.md b/pdd/README.md
similarity index 100%
rename from pdd-protocol-driven-development/README.md
rename to pdd/README.md
diff --git a/pdd-protocol-driven-development/figs/multistream-1.monopic b/pdd/figs/multistream-1.monopic
similarity index 100%
rename from pdd-protocol-driven-development/figs/multistream-1.monopic
rename to pdd/figs/multistream-1.monopic
diff --git a/pdd-protocol-driven-development/figs/multistream-1.txt b/pdd/figs/multistream-1.txt
similarity index 100%
rename from pdd-protocol-driven-development/figs/multistream-1.txt
rename to pdd/figs/multistream-1.txt
diff --git a/pdd-protocol-driven-development/figs/multistream-2.monopic b/pdd/figs/multistream-2.monopic
similarity index 100%
rename from pdd-protocol-driven-development/figs/multistream-2.monopic
rename to pdd/figs/multistream-2.monopic
diff --git a/pdd-protocol-driven-development/figs/multistream-2.txt b/pdd/figs/multistream-2.txt
similarity index 100%
rename from pdd-protocol-driven-development/figs/multistream-2.txt
rename to pdd/figs/multistream-2.txt
diff --git a/pdd-protocol-driven-development/figs/multistream-3.monopic b/pdd/figs/multistream-3.monopic
similarity index 100%
rename from pdd-protocol-driven-development/figs/multistream-3.monopic
rename to pdd/figs/multistream-3.monopic
diff --git a/pdd-protocol-driven-development/figs/multistream-3.txt b/pdd/figs/multistream-3.txt
similarity index 100%
rename from pdd-protocol-driven-development/figs/multistream-3.txt
rename to pdd/figs/multistream-3.txt