diff --git a/protocols/v2/roles-logic-sv2/README.md b/protocols/v2/roles-logic-sv2/README.md
new file mode 100644
index 0000000000..764978ea04
--- /dev/null
+++ b/protocols/v2/roles-logic-sv2/README.md
@@ -0,0 +1,34 @@
+# `roles_logic_sv2`
+
+[![crates.io](https://img.shields.io/crates/v/roles_logic_sv2.svg)](https://crates.io/crates/roles_logic_sv2)
+[![docs.rs](https://docs.rs/roles_logic_sv2/badge.svg)](https://docs.rs/roles_logic_sv2)
+[![rustc+](https://img.shields.io/badge/rustc-1.75.0%2B-lightgrey.svg)](https://blog.rust-lang.org/2023/12/28/Rust-1.75.0.html)
+[![license](https://img.shields.io/badge/license-MIT%2FApache--2.0-blue.svg)](https://github.com/stratum-mining/stratum/blob/main/LICENSE.md)
+[![codecov](https://codecov.io/gh/stratum-mining/stratum/branch/main/graph/badge.svg?flag=roles_logic_sv2-coverage)](https://codecov.io/gh/stratum-mining/stratum)
+
+`roles_logic_sv2` provides the core logic and utilities for implementing roles in the Stratum V2 (Sv2) protocol, such as miners, pools, and proxies. It abstracts message handling, channel management, job creation, and routing logic, enabling efficient and secure communication across upstream and downstream connections.
+
+## Main Components
+
+- **Channel Logic**: Manages the lifecycle and settings of communication channels (standard, extended, and group ones) between roles.
+- **Handlers**: Centralizes the processing and routing logic of Sv2 protocol messages.
+- **Job Management**: Facilitates the creation, validation, and dispatching of mining jobs.
+- **Parsers**: Handles serialization and deserialization of Sv2 messages.
+- **Routing Logic**: Implements message routing and downstream/upstream selector utilities.
+- **Utilities**: Provides helpers for safe locking, mining-specific calculations, and more.
+
+## Usage
+
+To include this crate in your project, run:
+
+```bash
+cargo add roles_logic_sv2
+```
+
+This crate can be built with the following feature flags:
+
+- `with_serde`: Enables serialization and deserialization support using the serde library. This feature flag also activates the with_serde feature for dependent crates such as `binary_sv2`, `common_messages_sv2`, `template_distribution_sv2`, `job_declaration_sv2`, and `mining_sv2`.
+  Note that this feature flag is only used for the Message Generator, and deprecated
+  for any other kind of usage. It will likely be fully deprecated in the future.
+- `prop_test`: Enables property-based testing features for template distribution logic, leveraging dependencies' testing capabilities such as `template_distribution_sv2` crate.
+- `disable_nopanic`: Disables the nopanic logic in scenarios where code coverage tools might conflict with it.
\ No newline at end of file