diff --git a/README.md b/README.md
index 0b7293b..1fdf62b 100644
--- a/README.md
+++ b/README.md
@@ -178,3 +178,6 @@ The `contracts/rewards` crate provides a deterministic reward simulation engine
 
 The simulation tests in `contracts/rewards/src/test.rs` document low-activity, target-activity, deterministic replay, pool-conservation, and invalid-input edge cases.
 simulated changes
+
+## Peer Message Handling Changes
+- Separated parsing, validation, dispatch, and error handling into focused modules.
diff --git a/src/network/mod.rs b/src/network/mod.rs
new file mode 100644
index 0000000..2f5d84f
--- /dev/null
+++ b/src/network/mod.rs
@@ -0,0 +1 @@
+// network layer
diff --git a/src/peer/mod.rs b/src/peer/mod.rs
new file mode 100644
index 0000000..98f82c9
--- /dev/null
+++ b/src/peer/mod.rs
@@ -0,0 +1 @@
+// peer message handling