diff --git a/crates/shared/access-lists/README.md b/crates/shared/access-lists/README.md
index 8366c9b8..19021b79 100644
--- a/crates/shared/access-lists/README.md
+++ b/crates/shared/access-lists/README.md
@@ -2,6 +2,8 @@
 
 A library to build and process Flashblock-level Access Lists (FBALs).
 
+See the [spec](../../../docs/specs/access-lists.md) for more details.
+
 ## Overview
 
 This crate provides types and utilities for tracking account and storage changes during EVM transaction execution, producing access lists that can be used by downstream consumers to understand exactly what state was read or modified.
diff --git a/docs/README.md b/docs/README.md
new file mode 100644
index 00000000..104027bb
--- /dev/null
+++ b/docs/README.md
@@ -0,0 +1,7 @@
+## Documents
+
+### Specs
+
+- [Access Lists Spec](./specs/access-lists.md)
+- [Flashblocks Spec](./specs/flashblocks.md)
+
diff --git a/crates/shared/access-lists/SPEC.md b/docs/specs/access-lists.md
similarity index 100%
rename from crates/shared/access-lists/SPEC.md
rename to docs/specs/access-lists.md
diff --git a/crates/client/flashblocks/spec.md b/docs/specs/flashblocks.md
similarity index 100%
rename from crates/client/flashblocks/spec.md
rename to docs/specs/flashblocks.md