move architecture to the root of the protocol directory

Author: apenzk

protocol/README.md

@@ -8,3 +8,27 @@
 - **[`pcp`](./pcp/README.md)**: the Postconfirmation sub-protocol implementation for `ffs`.
 - **[`fcp`](./fcp/README.md)**: the Fastconfirmation sub-protocol implementation for `ffs`.
 - **[`ffs`](./ffs/README.md)**: the full `ffs` protocol implementation.
+
+## Architecture for each protocol unit
+
+- `cli/` - Command line interface tools
+  - `client/` - CLI tool for users to interact with the protocol (posting commitments, querying state)
+  - `deployer/` - CLI tool for deploying the protocol contracts
+  - `protocol/` - CLI tool for protocol-specific operations
+
+- `clients/` - Protocol client implementations
+  - `eth/` - Ethereum client implementation that handles blockchain interactions
+  - `mock/` - Mock client for testing
+  - `util/` - Shared utilities for clients
+
+- `dlu/` - Deployment and Lifecycle Utilities
+  - `eth/` - Ethereum-specific deployment tools
+    - `contracts/` - Smart contract implementations. Includes settlement contracts for block commitments, staking contracts for validator management, token contracts for custody.
+    - `deployer-core/` - Core deployment logic
+    - `anvil/` - Local testnet configuration
+
+- `manager/` - Protocol management and orchestration. Manages block commitments by batching and submitting them, interacts with clients, and processes commitment events (acceptance or rejection) for the settlement system.
+
+- [`util/`](util/) - Shared utilities
+  - `config/` - Configuration management
+  - `types/` - Common type definitions

protocol/mcr/README.md

@@ -9,27 +9,3 @@ This directory contains the implementation of the MCR protocol, which handles ro
 The distinguishing feature to PCP is that there is only one type of actor, which is the attester.
 
 For further details see the [RFC for MCR](https://github.com/movementlabsxyz/rfcs/pull/29) and the [MIP-34](https://github.com/movementlabsxyz/MIP/blob/main/MIP/mip-34).
-
-## Architecture
-
-- [`cli/`](cli/) - Command line interface tools
-  - [`client/`](cli/client/) - CLI tool for users to interact with the protocol (posting commitments, querying state)
-  - [`deployer/`](cli/deployer/) - CLI tool for deploying the protocol contracts
-  - [`protocol/`](cli/protocol/) - CLI tool for protocol-specific operations
-
-- [`clients/`](clients/) - Protocol client implementations
-  - [`eth/`](clients/eth/) - Ethereum client implementation that handles blockchain interactions
-  - [`mock/`](clients/mock/) - Mock client for testing
-  - [`util/`](clients/util/) - Shared utilities for clients
-
-- [`dlu/`](dlu/) - Deployment and Lifecycle Utilities
-  - [`eth/`](dlu/eth/) - Ethereum-specific deployment tools
-    - [`contracts/`](dlu/eth/contracts/) - Smart contract implementations. Includes settlement contracts for block commitments, staking contracts for validator management, token contracts for custody.
-    - [`deployer-core/`](dlu/eth/deployer-core/) - Core deployment logic
-    - [`anvil/`](dlu/eth/anvil/) - Local testnet configuration
-
-- [`manager/`](manager/) - Protocol management and orchestration. Manages block commitments by batching and submitting them, interacts with clients, and processes commitment events (acceptance or rejection) for the settlement system.
-
-- [`util/`](util/) - Shared utilities
-  - [`config/`](util/config/) - Configuration management
-  - [`types/`](util/types/) - Common type definitions

protocol/pcp/README.md

@@ -9,20 +9,3 @@ This directory contains the implementation of the PCP protocol, which handles co
 The distinguishing feature to MCR is that there are two types of actors, which are the attesters and the acceptors.
 
 For further details see the [MIP-37](https://github.com/movementlabsxyz/MIP/blob/main/MIP/mip-37).
-
-## Architecture
-
-- [`cli/`](cli/) - Command line interface tools
-  - [`client/`](cli/client/) - CLI tool for users to interact with the protocol (posting commitments, querying state)
-  - [`deployer/`](cli/deployer/) - CLI tool for deploying the protocol contracts
-  - [`protocol/`](cli/protocol/) - CLI tool for protocol-specific operations
-
-- [`dlu/`](dlu/) - Deployment and Lifecycle Utilities
-  - [`eth/`](dlu/eth/) - Ethereum-specific deployment tools
-    - [`contracts/`](dlu/eth/contracts/) - Smart contract implementations for post-confirmation settlement
-    - [`deployer-core/`](dlu/eth/deployer-core/) - Core deployment logic for contracts
-    - [`anvil/`](dlu/eth/anvil/) - Local testnet configuration for development
-
-- [`util/`](util/) - Shared utilities
-  - [`config/`](util/config/) - Configuration management for PCP clients and deployments
-  - [`types/`](util/types/) - Common type definitions for PCP protocol