evstack · tac0turtle · Jul 21, 2025 · Jul 21, 2025 · Jul 21, 2025 · gemini-code-assist
diff --git a/.github/workflows/specs-deploy.yml b/.github/workflows/specs-deploy.yml
diff --git a/README.md b/README.md
@@ -93,16 +93,13 @@ make proto-lint
 1. Install [hadolint](https://github.com/hadolint/hadolint)
 1. Install [yamllint](https://yamllint.readthedocs.io/en/stable/quickstart.html)
 
-## Dependency graph
 
-To see our progress and a possible future of Rollkit visit our [Dependency
-Graph](https://github.com/rollkit/rollkit/blob/main/specs/src/specs/rollkit-dependency-graph.md).
 
 ## Audits
 
 | Date | Auditor | Version | Report |
 |---|---|---|---|
-| 2024/01/12 | [Informal Systems](https://informal.systems/) | [eccdd...bcb9d](https://github.com/rollkit/rollkit/commit/eccdd0f1793a5ac532011ef4d896de9e0d8bcb9d) | [informal-systems.pdf](specs/audit/informal-systems.pdf) |
-| 2024/01/10 | [Binary Builders](https://binary.builders/)   | [eccdd...bcb9d](https://github.com/rollkit/rollkit/commit/eccdd0f1793a5ac532011ef4d896de9e0d8bcb9d) | [binary-builders.pdf](specs/audit/binary-builders.pdf)   |
+| 2024/01/12 | [Informal Systems](https://informal.systems/) | [eccdd...bcb9d](https://github.com/rollkit/rollkit/commit/eccdd0f1793a5ac532011ef4d896de9e0d8bcb9d) | [informal-systems.pdf](docs/audit/informal-systems.pdf) |
+| 2024/01/10 | [Binary Builders](https://binary.builders/)   | [eccdd...bcb9d](https://github.com/rollkit/rollkit/commit/eccdd0f1793a5ac532011ef4d896de9e0d8bcb9d) | [binary-builders.pdf](docs/audit/binary-builders.pdf)   |
 
 [docs]: https://rollkit.dev
diff --git a/specs/.gitignore → docs/.gitignore b/specs/.gitignore → docs/.gitignore
diff --git a/specs/lazy-adr/adr-001-node-interface.md → docs/adr/adr-001-node-interface.md b/specs/lazy-adr/adr-001-node-interface.md → docs/adr/adr-001-node-interface.md
diff --git a/specs/lazy-adr/adr-002-mempool.md → docs/adr/adr-002-mempool.md b/specs/lazy-adr/adr-002-mempool.md → docs/adr/adr-002-mempool.md
diff --git a/specs/lazy-adr/adr-003-peer-discovery.md → docs/adr/adr-003-peer-discovery.md b/specs/lazy-adr/adr-003-peer-discovery.md → docs/adr/adr-003-peer-discovery.md
diff --git a/specs/lazy-adr/adr-004-core-types.md → docs/adr/adr-004-core-types.md b/specs/lazy-adr/adr-004-core-types.md → docs/adr/adr-004-core-types.md
diff --git a/specs/lazy-adr/adr-005-serialization.md → docs/adr/adr-005-serialization.md b/specs/lazy-adr/adr-005-serialization.md → docs/adr/adr-005-serialization.md
diff --git a/specs/lazy-adr/adr-006-da-interface.md → docs/adr/adr-006-da-interface.md b/specs/lazy-adr/adr-006-da-interface.md → docs/adr/adr-006-da-interface.md
diff --git a/...zy-adr/adr-007-header-commit-to-shares.md → docs/adr/adr-007-header-commit-to-shares.md b/...zy-adr/adr-007-header-commit-to-shares.md → docs/adr/adr-007-header-commit-to-shares.md
diff --git a/.../adr-008-mempool-optimint-light-client.md → .../adr-008-mempool-optimint-light-client.md b/.../adr-008-mempool-optimint-light-client.md → .../adr-008-mempool-optimint-light-client.md
diff --git a/specs/lazy-adr/adr-009-state-fraud-proofs.md → docs/adr/adr-009-state-fraud-proofs.md b/specs/lazy-adr/adr-009-state-fraud-proofs.md → docs/adr/adr-009-state-fraud-proofs.md
diff --git a/specs/lazy-adr/adr-010-exec-api.md → docs/adr/adr-010-exec-api.md b/specs/lazy-adr/adr-010-exec-api.md → docs/adr/adr-010-exec-api.md
diff --git a/specs/lazy-adr/adr-011-remote-signer.md → docs/adr/adr-011-remote-signer.md b/specs/lazy-adr/adr-011-remote-signer.md → docs/adr/adr-011-remote-signer.md
diff --git a/specs/lazy-adr/adr-012-based-sequencing.md → docs/adr/adr-012-based-sequencing.md b/specs/lazy-adr/adr-012-based-sequencing.md → docs/adr/adr-012-based-sequencing.md
diff --git a/specs/lazy-adr/adr-013-single-sequencer.md → docs/adr/adr-013-single-sequencer.md b/specs/lazy-adr/adr-013-single-sequencer.md → docs/adr/adr-013-single-sequencer.md
diff --git a/...adr/adr-014-header-and-data-separation.md → ...adr/adr-014-header-and-data-separation.md b/...adr/adr-014-header-and-data-separation.md → ...adr/adr-014-header-and-data-separation.md
diff --git a/...azy-adr/adr-015-rollkit-minimal-header.md → docs/adr/adr-015-rollkit-minimal-header.md b/...azy-adr/adr-015-rollkit-minimal-header.md → docs/adr/adr-015-rollkit-minimal-header.md
diff --git a/specs/lazy-adr/adr-016-genesis-file.md → docs/adr/adr-016-genesis-file.md b/specs/lazy-adr/adr-016-genesis-file.md → docs/adr/adr-016-genesis-file.md
diff --git a/specs/lazy-adr/adr-017-node-pruning.md → docs/adr/adr-017-node-pruning.md b/specs/lazy-adr/adr-017-node-pruning.md → docs/adr/adr-017-node-pruning.md
diff --git a/specs/lazy-adr/adr-018-rpc.md → docs/adr/adr-018-rpc.md b/specs/lazy-adr/adr-018-rpc.md → docs/adr/adr-018-rpc.md
diff --git a/...adr/adr-019-forced-inclusion-mechanism.md → ...adr/adr-019-forced-inclusion-mechanism.md b/...adr/adr-019-forced-inclusion-mechanism.md → ...adr/adr-019-forced-inclusion-mechanism.md
@@ -436,7 +436,7 @@ Proposed
 
 ## References
 
-- [Rollkit Single Sequencer ADR-013](https://github.com/rollkit/rollkit/blob/main/specs/lazy-adr/adr-013-single-sequencer.md)
-- [Rollkit Minimal Header ADR-015](https://github.com/rollkit/rollkit/blob/main/specs/lazy-adr/adr-015-rollkit-minimal-header.md)
+- [Rollkit Single Sequencer ADR-013](https://github.com/rollkit/rollkit/blob/main/docs/adr/adr-013-single-sequencer.md)
+- [Rollkit Minimal Header ADR-015](https://github.com/rollkit/rollkit/blob/main/docs/adr/adr-015-rollkit-minimal-header.md)
 - [L2 Beat Stages Framework](https://forum.l2beat.com/t/the-stages-framework/291#p-516-stage-1-requirements-3)
 - [GitHub Issue #1914: Add Forced Inclusion Mechanism from the DA layer](https://github.com/rollkit/rollkit/issues/1914)
diff --git a/specs/lazy-adr/adr-020-validation.md → docs/adr/adr-020-validation.md b/specs/lazy-adr/adr-020-validation.md → docs/adr/adr-020-validation.md
diff --git a/specs/lazy-adr/adr-021-lazy-aggregation.md → docs/adr/adr-021-lazy-aggregation.md b/specs/lazy-adr/adr-021-lazy-aggregation.md → docs/adr/adr-021-lazy-aggregation.md
diff --git a/specs/lazy-adr/adr-022-validator-network.md → docs/adr/adr-022-validator-network.md b/specs/lazy-adr/adr-022-validator-network.md → docs/adr/adr-022-validator-network.md
diff --git a/specs/lazy-adr/adr-template.md → docs/adr/adr-template.md b/specs/lazy-adr/adr-template.md → docs/adr/adr-template.md
diff --git a/...lazy-adr/figures/header_shares_commit.jpg → docs/adr/figures/header_shares_commit.jpg b/...lazy-adr/figures/header_shares_commit.jpg → docs/adr/figures/header_shares_commit.jpg
diff --git a/specs/audit/binary-builders.pdf → docs/audit/binary-builders.pdf b/specs/audit/binary-builders.pdf → docs/audit/binary-builders.pdf
diff --git a/specs/audit/informal-systems.pdf → docs/audit/informal-systems.pdf b/specs/audit/informal-systems.pdf → docs/audit/informal-systems.pdf
diff --git a/scripts/utils.mk b/scripts/utils.mk
@@ -15,7 +15,7 @@ lint: vet
 	@echo "--> Running golangci-lint"
 	@golangci-lint run
 	@echo "--> Running markdownlint"
-	@markdownlint --config .markdownlint.yaml --ignore './specs/src/specs/**.md' '**/*.md'
+	@markdownlint --config .markdownlint.yaml '**/*.md'
 	@echo "--> Running hadolint"
 	@hadolint test/docker/mockserv.Dockerfile
 	@echo "--> Running yamllint"
@@ -31,7 +31,7 @@ lint-fix:
 	@echo "--> Formatting go"
 	@golangci-lint run --fix
 	@echo "--> Formatting markdownlint"
-	@markdownlint --config .markdownlint.yaml --ignore './specs/src/specs/**.md' '**/*.md' -f
+	@markdownlint --config .markdownlint.yaml --ignore './docs/src/specs/**.md' '**/*.md' -f
 .PHONY: lint-fix
 
 ## vet: Run go vet

diff --git a/specs/README.md b/specs/README.md
diff --git a/specs/book.toml b/specs/book.toml
diff --git a/specs/src/README.md b/specs/src/README.md
diff --git a/specs/src/SUMMARY.md b/specs/src/SUMMARY.md