Skip to content
6 changes: 3 additions & 3 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ The site is organized into layers, each targeting a different audience:
| ----------------------- | --------------------------------------------------------- | ------------------------------- | ---------------------------------- |
| **User Guide** | `docs/user/` | End users (wallets, DeFi users) | Plain language, no code |
| **Developer Docs** | `docs/dev/` | Dapp/contract builders | Practical guidance, code examples |
| **Stateless Validator** | `docs/stateless/` | Node operators | Reference, copy-paste commands |
| **Stateless Validator** | `docs/node/` | Node operators | Reference, copy-paste commands |
| **Specification** | [mega-evm repo](https://github.com/megaeth-labs/mega-evm) | Protocol implementers, auditors | Normative (MUST/SHALL), exhaustive |

Each layer has its own `AGENTS.md` with layer-specific writing rules.
Expand All @@ -43,8 +43,8 @@ It does not live in this repo — do not create or edit `docs/spec/` files here.
│ │ ├── read/ # Reading from MegaETH (RPC, realtime API)
│ │ │ └── rpc/ # RPC method reference pages
│ │ └── execution/ # EVM differences, gas model, resource limits
│ └── stateless/ # Stateless Validator layer
│ ├── AGENTS.md # Stateless layer writing rules
│ └── node/ # Stateless Validator layer
│ ├── AGENTS.md # Node layer writing rules
│ └── *.md
├── .sisyphus/plans/ # Restructure planning docs
└── .github/workflows/
Expand Down
2 changes: 1 addition & 1 deletion docs/AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ The documentation has two tonal registers depending on where a page lives:
Build an argument. Walk the reader through reasoning. Explain _why_ things are the way they are.
These pages read like a well-written technical blog post — engaging, flowing prose that tells a story.

- **Layer pages** (`user/`, `dev/`, `stateless/`, `spec/`) use a **terse, reference tone**.
- **Layer pages** (`user/`, `dev/`, `node/`, `spec/`) use a **terse, reference tone**.
Short declarative sentences. Sentence fragments in table cells. Facts first, explanation second.
Optimized for scanning and quick lookup. Each layer's `AGENTS.md` has additional tone rules.

Expand Down
3 changes: 2 additions & 1 deletion docs/SUMMARY.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,4 +43,5 @@

## Node Operation

- [Stateless Validation](stateless/stateless-validator.md)
- [Stateless Validation](node/stateless-validation.md)
- [Get Block Witness](node/witness.md)
File renamed without changes.
Original file line number Diff line number Diff line change
Expand Up @@ -313,6 +313,7 @@ Histograms like `block_validation_time_seconds`, `witness_verification_time_seco

## Related pages

- [Get Block Witness](witness.md) — `mega_getBlockWitness` RPC reference and witness data layout
- [Architecture](../architecture.md) — how transactions flow through MegaETH and where validators fit in
- [stateless-validator source](https://github.com/megaeth-labs/stateless-validator) — Rust client source code
- [SALT](https://github.com/megaeth-labs/salt) — MegaETH's state trie and witness format
Loading
Loading