base · refcell · Jan 10, 2026 · Jan 9, 2026 · Jan 9, 2026 · Jan 9, 2026
diff --git 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
@@ -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 → docs/specs/access-lists.md b/crates/shared/access-lists/SPEC.md → docs/specs/access-lists.md
diff --git a/crates/client/flashblocks/spec.md → docs/specs/flashblocks.md b/crates/client/flashblocks/spec.md → docs/specs/flashblocks.md