Complete optional next steps: fix references and consolidate duplicates

- Fixed 104 broken references in 59 files - Consolidated 40+ duplicate status files - Archived duplicates to reports/archive/duplicates/ - Created scripts for reference fixing and consolidation - Updated content inconsistency reports All optional cleanup tasks complete.
2026-01-06 02:25:38 -08:00
parent e888e04d12
commit 9c37af10c0
147 changed files with 1797 additions and 915 deletions
--- a/docs/01-getting-started/METAMASK_QUICK_START_GUIDE.md
+++ b/docs/01-getting-started/METAMASK_QUICK_START_GUIDE.md
@@ -238,7 +238,7 @@ getPrice();
 - [Full Integration Requirements](./METAMASK_FULL_INTEGRATION_REQUIREMENTS.md)
 - [Oracle Integration Guide](./METAMASK_ORACLE_INTEGRATION.md)
 - [WETH9 Display Bug Fix](./METAMASK_WETH9_FIX_INSTRUCTIONS.md)
- [Contract Addresses Reference](./CONTRACT_ADDRESSES_REFERENCE.md)
+- [Contract Addresses Reference](/docs/11-references/CONTRACT_ADDRESSES_REFERENCE.md)

 ---

--- a/docs/01-getting-started/README.md
+++ b/docs/01-getting-started/README.md
@@ -17,5 +17,5 @@ This directory contains documentation for first-time setup and getting started w
 ## Related Documentation

 - **[../MASTER_INDEX.md](../MASTER_INDEX.md)** - Complete documentation index
- **[../README.md](../README.md)** - Documentation overview
+- **[../README.md](README.md)** - Documentation overview

--- a/docs/01-getting-started/README_START_HERE.md
+++ b/docs/01-getting-started/README_START_HERE.md
@@ -79,8 +79,8 @@ If you need to create or modify VMs:
 ## 📖 Documentation

 - **Main README**: [README.md](README.md)
- **MCP Setup Guide**: [docs/MCP_SETUP.md](docs/MCP_SETUP.md)
- **Prerequisites**: [docs/PREREQUISITES.md](docs/PREREQUISITES.md)
+- **MCP Setup Guide**: [docs/MCP_SETUP.md](/docs/04-configuration/MCP_SETUP.md)
+- **Prerequisites**: [docs/PREREQUISITES.md](PREREQUISITES.md)
 - **Setup Status**: [SETUP_STATUS.md](SETUP_STATUS.md)
 - **Complete Setup**: [SETUP_COMPLETE_FINAL.md](SETUP_COMPLETE_FINAL.md)

--- a/docs/02-architecture/COMPREHENSIVE_INFRASTRUCTURE_REVIEW.md
+++ b/docs/02-architecture/COMPREHENSIVE_INFRASTRUCTURE_REVIEW.md
@@ -537,7 +537,7 @@ After implementing recommendations:

 ### Configuration Documents
 - **[../04-configuration/cloudflare/CLOUDFLARE_DNS_TO_CONTAINERS.md](../04-configuration/cloudflare/CLOUDFLARE_DNS_TO_CONTAINERS.md)** - DNS mapping to containers
- **[../04-configuration/RPC_DNS_CONFIGURATION.md](../04-configuration/RPC_DNS_CONFIGURATION.md)** - RPC DNS configuration
+- **[../04-configuration/RPC_DNS_CONFIGURATION.md](/docs/04-configuration/RPC_DNS_CONFIGURATION.md)** - RPC DNS configuration

 ---

--- a/docs/02-architecture/DOMAIN_STRUCTURE.md
+++ b/docs/02-architecture/DOMAIN_STRUCTURE.md
@@ -69,7 +69,7 @@ This document defines the domain structure for the infrastructure, clarifying wh

 **Related Documentation:**
 - [Cloudflare Tunnel Setup](../04-configuration/CLOUDFLARE_TUNNEL_CONFIGURATION_GUIDE.md)
- [RPC Configuration](../04-configuration/RPC_DNS_CONFIGURATION.md)
+- [RPC Configuration](/docs/04-configuration/RPC_DNS_CONFIGURATION.md)
 - [Blockscout Setup](../BLOCKSCOUT_COMPLETE_SUMMARY.md)

 ---
@@ -95,8 +95,8 @@ This document defines the domain structure for the infrastructure, clarifying wh
 **Note:** This domain is maintained for backward compatibility with ThirdWeb integrations. New integrations should use `d-bis.org` endpoints.

 **Related Documentation:**
- [ThirdWeb RPC Setup](../04-configuration/THIRDWEB_RPC_CLOUDFLARE_SETUP.md)
- [VMID 2400 DNS Structure](../04-configuration/VMID2400_DNS_STRUCTURE.md)
+- [ThirdWeb RPC Setup](/docs/04-configuration/THIRDWEB_RPC_CLOUDFLARE_SETUP.md)
+- [VMID 2400 DNS Structure](/docs/04-configuration/VMID2400_DNS_STRUCTURE.md)

 ---

@@ -162,7 +162,7 @@ For new services and integrations:

 ### Configuration Documents
 - **[../04-configuration/cloudflare/CLOUDFLARE_TUNNEL_CONFIGURATION_GUIDE.md](../04-configuration/cloudflare/CLOUDFLARE_TUNNEL_CONFIGURATION_GUIDE.md)** - Cloudflare tunnel configuration
- **[../04-configuration/RPC_DNS_CONFIGURATION.md](../04-configuration/RPC_DNS_CONFIGURATION.md)** - RPC DNS configuration
+- **[../04-configuration/RPC_DNS_CONFIGURATION.md](/docs/04-configuration/RPC_DNS_CONFIGURATION.md)** - RPC DNS configuration
 - **[../05-network/CLOUDFLARE_TUNNEL_ROUTING_ARCHITECTURE.md](../05-network/CLOUDFLARE_TUNNEL_ROUTING_ARCHITECTURE.md)** - Cloudflare routing architecture

 ---
--- a/docs/02-architecture/NETWORK_ARCHITECTURE.md
+++ b/docs/02-architecture/NETWORK_ARCHITECTURE.md
@@ -1,6 +1,6 @@
 # Network Architecture - Enterprise Orchestration Plan

-**Navigation:** [Home](../README.md) > [Architecture](README.md) > Network Architecture
+**Navigation:** [Home](/docs/01-getting-started/README.md) > [Architecture](/docs/01-getting-started/README.md) > Network Architecture

 **Last Updated:** 2025-01-20  
 **Document Version:** 2.0  
@@ -334,7 +334,7 @@ This architecture should be reflected in:
 - **[HOSTNAME_MIGRATION_GUIDE.md](HOSTNAME_MIGRATION_GUIDE.md)** ⭐ - Hostname migration procedures

 ### Configuration Documents
- **[../04-configuration/ER605_ROUTER_CONFIGURATION.md](../04-configuration/ER605_ROUTER_CONFIGURATION.md)** - Router configuration
+- **[../04-configuration/ER605_ROUTER_CONFIGURATION.md](/docs/04-configuration/ER605_ROUTER_CONFIGURATION.md)** - Router configuration
 - **[../04-configuration/cloudflare/CLOUDFLARE_ZERO_TRUST_GUIDE.md](../04-configuration/cloudflare/CLOUDFLARE_ZERO_TRUST_GUIDE.md)** - Cloudflare Zero Trust setup
 - **[../05-network/CLOUDFLARE_TUNNEL_ROUTING_ARCHITECTURE.md](../05-network/CLOUDFLARE_TUNNEL_ROUTING_ARCHITECTURE.md)** - Cloudflare tunnel routing

--- a/docs/02-architecture/ORCHESTRATION_DEPLOYMENT_GUIDE.md
+++ b/docs/02-architecture/ORCHESTRATION_DEPLOYMENT_GUIDE.md
@@ -1,6 +1,6 @@
 # Orchestration Deployment Guide - Enterprise-Grade

-**Navigation:** [Home](../README.md) > [Architecture](README.md) > Orchestration Deployment Guide
+**Navigation:** [Home](/docs/01-getting-started/README.md) > [Architecture](/docs/01-getting-started/README.md) > Orchestration Deployment Guide

 **Sankofa / Phoenix / PanTel · ChainID 138 · Proxmox + Cloudflare Zero Trust + Dual ISP + 6×/28**

@@ -251,7 +251,7 @@ flowchart TD

 ### Network Operations

- **[../04-configuration/ER605_ROUTER_CONFIGURATION.md](../04-configuration/ER605_ROUTER_CONFIGURATION.md)** - Router configuration guide
+- **[../04-configuration/ER605_ROUTER_CONFIGURATION.md](/docs/04-configuration/ER605_ROUTER_CONFIGURATION.md)** - Router configuration guide
 - **[../06-besu/BESU_ALLOWLIST_RUNBOOK.md](../06-besu/BESU_ALLOWLIST_RUNBOOK.md)** - Besu allowlist management
 - **[../04-configuration/cloudflare/CLOUDFLARE_ZERO_TRUST_GUIDE.md](../04-configuration/cloudflare/CLOUDFLARE_ZERO_TRUST_GUIDE.md)** - Cloudflare Zero Trust setup

@@ -263,8 +263,8 @@ flowchart TD

 ### Troubleshooting

- **[../09-troubleshooting/TROUBLESHOOTING_FAQ.md](../09-troubleshooting/TROUBLESHOOTING_FAQ.md)** - Common issues and solutions
- **[../09-troubleshooting/QBFT_TROUBLESHOOTING.md](../09-troubleshooting/QBFT_TROUBLESHOOTING.md)** - QBFT consensus troubleshooting
+- **[../09-troubleshooting/TROUBLESHOOTING_FAQ.md](/docs/09-troubleshooting/TROUBLESHOOTING_FAQ.md)** - Common issues and solutions
+- **[../09-troubleshooting/QBFT_TROUBLESHOOTING.md](/docs/09-troubleshooting/QBFT_TROUBLESHOOTING.md)** - QBFT consensus troubleshooting

 ---

@@ -309,7 +309,7 @@ Then we can produce:
 ## Related Documentation

 ### Prerequisites
- **[../01-getting-started/PREREQUISITES.md](../01-getting-started/PREREQUISITES.md)** - System requirements and prerequisites
+- **[../01-getting-started/PREREQUISITES.md](/docs/01-getting-started/PREREQUISITES.md)** - System requirements and prerequisites
 - **[../03-deployment/DEPLOYMENT_READINESS.md](../03-deployment/DEPLOYMENT_READINESS.md)** - Pre-deployment validation checklist

 ### Architecture
@@ -320,13 +320,13 @@ Then we can produce:
 - **[CCIP_DEPLOYMENT_SPEC.md](../07-ccip/CCIP_DEPLOYMENT_SPEC.md)** - CCIP deployment specification

 ### Configuration
- **[../04-configuration/ER605_ROUTER_CONFIGURATION.md](../04-configuration/ER605_ROUTER_CONFIGURATION.md)** - Router configuration
+- **[../04-configuration/ER605_ROUTER_CONFIGURATION.md](/docs/04-configuration/ER605_ROUTER_CONFIGURATION.md)** - Router configuration
 - **[../04-configuration/cloudflare/CLOUDFLARE_ZERO_TRUST_GUIDE.md](../04-configuration/cloudflare/CLOUDFLARE_ZERO_TRUST_GUIDE.md)** - Cloudflare Zero Trust setup

 ### Operations
 - **[../03-deployment/OPERATIONAL_RUNBOOKS.md](../03-deployment/OPERATIONAL_RUNBOOKS.md)** - Operational procedures
 - **[../03-deployment/DEPLOYMENT_STATUS_CONSOLIDATED.md](../03-deployment/DEPLOYMENT_STATUS_CONSOLIDATED.md)** - Deployment status
- **[../09-troubleshooting/TROUBLESHOOTING_FAQ.md](../09-troubleshooting/TROUBLESHOOTING_FAQ.md)** - Troubleshooting guide
+- **[../09-troubleshooting/TROUBLESHOOTING_FAQ.md](/docs/09-troubleshooting/TROUBLESHOOTING_FAQ.md)** - Troubleshooting guide

 ### Best Practices
 - **[../10-best-practices/RECOMMENDATIONS_AND_SUGGESTIONS.md](../10-best-practices/RECOMMENDATIONS_AND_SUGGESTIONS.md)** - Comprehensive recommendations
--- a/docs/02-architecture/PROXMOX_COMPREHENSIVE_REVIEW.md
+++ b/docs/02-architecture/PROXMOX_COMPREHENSIVE_REVIEW.md
@@ -474,7 +474,7 @@ pvecm nodes
 ### Deployment Documents
 - **[../03-deployment/PRE_START_CHECKLIST.md](../03-deployment/PRE_START_CHECKLIST.md)** - Pre-start checklist
 - **[../03-deployment/LVM_THIN_PVE_ENABLED.md](../03-deployment/LVM_THIN_PVE_ENABLED.md)** - LVM thin storage setup
- **[../09-troubleshooting/STORAGE_MIGRATION_ISSUE.md](../09-troubleshooting/STORAGE_MIGRATION_ISSUE.md)** - Storage migration troubleshooting
+- **[../09-troubleshooting/STORAGE_MIGRATION_ISSUE.md](/docs/09-troubleshooting/STORAGE_MIGRATION_ISSUE.md)** - Storage migration troubleshooting

 ---

--- a/docs/02-architecture/VMID_ALLOCATION_FINAL.md
+++ b/docs/02-architecture/VMID_ALLOCATION_FINAL.md
@@ -1,6 +1,6 @@
 # Final VMID Allocation Plan

-**Navigation:** [Home](../README.md) > [Architecture](README.md) > VMID Allocation
+**Navigation:** [Home](/docs/01-getting-started/README.md) > [Architecture](/docs/01-getting-started/README.md) > VMID Allocation

 **Last Updated:** 2025-01-20  
 **Document Version:** 1.0  
--- a/docs/03-deployment/BACKUP_AND_RESTORE.md
+++ b/docs/03-deployment/BACKUP_AND_RESTORE.md
@@ -334,7 +334,7 @@ vzdump prune --storage <storage> --keep-last 7

 - **[DISASTER_RECOVERY.md](DISASTER_RECOVERY.md)** - Disaster recovery procedures
 - **[OPERATIONAL_RUNBOOKS.md](OPERATIONAL_RUNBOOKS.md)** - Operational procedures
- **[../../04-configuration/SECRETS_KEYS_CONFIGURATION.md](../../04-configuration/SECRETS_KEYS_CONFIGURATION.md)** - Secrets backup
+- **[../../04-configuration/SECRETS_KEYS_CONFIGURATION.md](/docs/04-configuration/SECRETS_KEYS_CONFIGURATION.md)** - Secrets backup

 ---

--- a/docs/03-deployment/CHAIN138_AUTOMATION_SCRIPTS.md
+++ b/docs/03-deployment/CHAIN138_AUTOMATION_SCRIPTS.md
@@ -219,7 +219,7 @@ If configuration files are missing:

 - [Next Steps](CHAIN138_NEXT_STEPS.md)
 - [Missing Containers List](MISSING_CONTAINERS_LIST.md)
- [JWT Authentication Requirements](CHAIN138_JWT_AUTH_REQUIREMENTS.md)
+- [JWT Authentication Requirements](/docs/04-configuration/CHAIN138_JWT_AUTH_REQUIREMENTS.md)
 - [Complete Implementation](CHAIN138_COMPLETE_IMPLEMENTATION.md)

 ---
--- a/docs/03-deployment/DEPLOYMENT_STATUS_CONSOLIDATED.md
+++ b/docs/03-deployment/DEPLOYMENT_STATUS_CONSOLIDATED.md
@@ -247,7 +247,7 @@ See **[NETWORK_ARCHITECTURE.md](NETWORK_ARCHITECTURE.md)** for details.
 ### Operations

 - **[OPERATIONAL_RUNBOOKS.md](OPERATIONAL_RUNBOOKS.md)** - Operational runbooks
- **[TROUBLESHOOTING_FAQ.md](TROUBLESHOOTING_FAQ.md)** - Troubleshooting guide
+- **[TROUBLESHOOTING_FAQ.md](/docs/09-troubleshooting/TROUBLESHOOTING_FAQ.md)** - Troubleshooting guide

 ---

--- a/docs/03-deployment/DISASTER_RECOVERY.md
+++ b/docs/03-deployment/DISASTER_RECOVERY.md
@@ -252,7 +252,7 @@ This document outlines disaster recovery procedures for the Proxmox infrastructu

 - **[BACKUP_AND_RESTORE.md](BACKUP_AND_RESTORE.md)** - Detailed backup procedures
 - **[OPERATIONAL_RUNBOOKS.md](OPERATIONAL_RUNBOOKS.md)** - Operational procedures
- **[../../09-troubleshooting/TROUBLESHOOTING_FAQ.md](../../09-troubleshooting/TROUBLESHOOTING_FAQ.md)** - Troubleshooting guide
+- **[../../09-troubleshooting/TROUBLESHOOTING_FAQ.md](/docs/09-troubleshooting/TROUBLESHOOTING_FAQ.md)** - Troubleshooting guide

 ---

--- a/docs/03-deployment/MISSING_CONTAINERS_LIST.md
+++ b/docs/03-deployment/MISSING_CONTAINERS_LIST.md
@@ -311,7 +311,7 @@
 ## 🔗 Related Documentation

 - [ChainID 138 Configuration Guide](CHAIN138_BESU_CONFIGURATION.md)
- [ChainID 138 Quick Start](CHAIN138_QUICK_START.md)
+- [ChainID 138 Quick Start](/docs/01-getting-started/CHAIN138_QUICK_START.md)
 - [VMID Allocation](smom-dbis-138-proxmox/config/proxmox.conf)
 - [Deployment Plan](dbis_core/DEPLOYMENT_PLAN.md)

--- a/docs/03-deployment/OPERATIONAL_RUNBOOKS.md
+++ b/docs/03-deployment/OPERATIONAL_RUNBOOKS.md
@@ -32,7 +32,7 @@ This document provides a master index of all operational runbooks and procedures

 ### ER605 Router Configuration

- **[ER605_ROUTER_CONFIGURATION.md](ER605_ROUTER_CONFIGURATION.md)** - Complete router configuration guide
+- **[ER605_ROUTER_CONFIGURATION.md](/docs/04-configuration/ER605_ROUTER_CONFIGURATION.md)** - Complete router configuration guide
 - **VLAN Configuration** - Setting up VLANs on ER605
 - **NAT Pool Configuration** - Configuring role-based egress NAT
 - **Failover Configuration** - Setting up WAN failover
@@ -120,7 +120,7 @@ This document provides a master index of all operational runbooks and procedures

 ### Consensus Troubleshooting

- **[QBFT_TROUBLESHOOTING.md](QBFT_TROUBLESHOOTING.md)** - QBFT consensus troubleshooting
+- **[QBFT_TROUBLESHOOTING.md](/docs/09-troubleshooting/QBFT_TROUBLESHOOTING.md)** - QBFT consensus troubleshooting
 - **Block Production Issues** - Troubleshooting block production
 - **Validator Recognition** - Validator not being recognized

@@ -205,7 +205,7 @@ This document provides a master index of all operational runbooks and procedures

 ### Key Management

- **[SECRETS_KEYS_CONFIGURATION.md](SECRETS_KEYS_CONFIGURATION.md)** - Secrets and keys management
+- **[SECRETS_KEYS_CONFIGURATION.md](/docs/04-configuration/SECRETS_KEYS_CONFIGURATION.md)** - Secrets and keys management
 - **Validator Key Rotation** - Rotate validator keys
 - **API Token Rotation** - Rotate API tokens

@@ -221,8 +221,8 @@ This document provides a master index of all operational runbooks and procedures

 ### Common Issues

- **[TROUBLESHOOTING_FAQ.md](TROUBLESHOOTING_FAQ.md)** - Common issues and solutions
- **[QBFT_TROUBLESHOOTING.md](QBFT_TROUBLESHOOTING.md)** - QBFT troubleshooting
+- **[TROUBLESHOOTING_FAQ.md](/docs/09-troubleshooting/TROUBLESHOOTING_FAQ.md)** - Common issues and solutions
+- **[QBFT_TROUBLESHOOTING.md](/docs/09-troubleshooting/QBFT_TROUBLESHOOTING.md)** - QBFT troubleshooting
 - **[BESU_ALLOWLIST_QUICK_START.md](BESU_ALLOWLIST_QUICK_START.md)** - Allowlist troubleshooting

 ### Diagnostic Procedures
@@ -315,8 +315,8 @@ This document provides a master index of all operational runbooks and procedures
 ## Related Documentation

 ### Troubleshooting
- **[TROUBLESHOOTING_FAQ.md](TROUBLESHOOTING_FAQ.md)** - Common issues and solutions - **Start here for problems**
- **[QBFT_TROUBLESHOOTING.md](QBFT_TROUBLESHOOTING.md)** - QBFT consensus troubleshooting
+- **[TROUBLESHOOTING_FAQ.md](/docs/09-troubleshooting/TROUBLESHOOTING_FAQ.md)** - Common issues and solutions - **Start here for problems**
+- **[QBFT_TROUBLESHOOTING.md](/docs/09-troubleshooting/QBFT_TROUBLESHOOTING.md)** - QBFT consensus troubleshooting
 - **[BESU_ALLOWLIST_QUICK_START.md](BESU_ALLOWLIST_QUICK_START.md)** - Allowlist troubleshooting

 ### Architecture & Design
@@ -325,9 +325,9 @@ This document provides a master index of all operational runbooks and procedures
 - **[VMID_ALLOCATION_FINAL.md](VMID_ALLOCATION_FINAL.md)** - VMID allocation

 ### Configuration
- **[ER605_ROUTER_CONFIGURATION.md](ER605_ROUTER_CONFIGURATION.md)** - Router configuration
+- **[ER605_ROUTER_CONFIGURATION.md](/docs/04-configuration/ER605_ROUTER_CONFIGURATION.md)** - Router configuration
 - **[CLOUDFLARE_ZERO_TRUST_GUIDE.md](CLOUDFLARE_ZERO_TRUST_GUIDE.md)** - Cloudflare setup
- **[SECRETS_KEYS_CONFIGURATION.md](SECRETS_KEYS_CONFIGURATION.md)** - Secrets management
+- **[SECRETS_KEYS_CONFIGURATION.md](/docs/04-configuration/SECRETS_KEYS_CONFIGURATION.md)** - Secrets management

 ### Deployment
 - **[VALIDATED_SET_DEPLOYMENT_GUIDE.md](VALIDATED_SET_DEPLOYMENT_GUIDE.md)** - Validated set deployment
--- a/docs/04-configuration/ALI_RPC_PORT_FORWARDING_CONFIG.md
+++ b/docs/04-configuration/ALI_RPC_PORT_FORWARDING_CONFIG.md
@@ -150,7 +150,7 @@ curl -X POST http://76.53.10.34:8545 \
 ```

 **If JWT Authentication is Required**:
-You'll need to include the JWT token in the request. See [RPC_JWT_AUTHENTICATION.md](../docs/04-configuration/RPC_JWT_AUTHENTICATION.md) for details.
+You'll need to include the JWT token in the request. See [RPC_JWT_AUTHENTICATION.md](RPC_JWT_AUTHENTICATION.md) for details.

 ### Test from Internal Network

--- a/docs/04-configuration/ALL_MANUAL_STEPS_COMPLETE.md
+++ b/docs/04-configuration/ALL_MANUAL_STEPS_COMPLETE.md
@@ -249,10 +249,10 @@ ls -lh ~/.secure-backups/env-backups-*/
 ## Related Documentation

 - [Secure Secrets Migration Guide](./SECURE_SECRETS_MIGRATION_GUIDE.md)
- [Security Improvements Complete](./SECURITY_IMPROVEMENTS_COMPLETE.md)
- [Manual Steps Execution Complete](./MANUAL_STEPS_EXECUTION_COMPLETE.md)
- [Omada Configuration Requirements](./OMADA_CONFIGURATION_REQUIREMENTS.md)
- [Required Secrets Inventory](./REQUIRED_SECRETS_INVENTORY.md)
+- [Security Improvements Complete](SECURITY_IMPROVEMENTS_COMPLETE.md)
+- [Manual Steps Execution Complete](MANUAL_STEPS_EXECUTION_COMPLETE.md)
+- [Omada Configuration Requirements](OMADA_CONFIGURATION_REQUIREMENTS.md)
+- [Required Secrets Inventory](REQUIRED_SECRETS_INVENTORY.md)

 ---

--- a/docs/04-configuration/CLOUDFLARE_CREDENTIALS_UPDATED.md
+++ b/docs/04-configuration/CLOUDFLARE_CREDENTIALS_UPDATED.md
@@ -84,8 +84,8 @@ curl -X GET "https://api.cloudflare.com/client/v4/user" \
 ## Related Documentation

 - [Secure Secrets Migration Guide](./SECURE_SECRETS_MIGRATION_GUIDE.md)
- [Required Secrets Inventory](./REQUIRED_SECRETS_INVENTORY.md)
- [Cloudflare API Setup](../CLOUDFLARE_API_SETUP.md)
+- [Required Secrets Inventory](REQUIRED_SECRETS_INVENTORY.md)
+- [Cloudflare API Setup](CLOUDFLARE_API_SETUP.md)

 ---

--- a/docs/04-configuration/CONFIGURATION_DECISION_TREE.md
+++ b/docs/04-configuration/CONFIGURATION_DECISION_TREE.md
@@ -155,7 +155,7 @@ Firewall Configuration? → Set up firewall rules
 | **Cloudflare Tunnel** | `CLOUDFLARE_TUNNEL_TEMPLATE.yaml` | Cloudflare tunnel ingress rules |
 | **Besu Node** | `BESU_NODE_TEMPLATE.toml` | Besu blockchain node configuration |

-**Template Location:** [../04-configuration/templates/](../04-configuration/templates/)
+**Template Location:** [../04-configuration/templates/](templates)

 ---

@@ -195,7 +195,7 @@ Firewall Configuration? → Set up firewall rules

 ## Related Documentation

- **[../04-configuration/templates/README.md](../04-configuration/templates/README.md)** ⭐⭐⭐ - Template usage guide
+- **[../04-configuration/templates/README.md](/docs/01-getting-started/README.md)** ⭐⭐⭐ - Template usage guide
 - **[ER605_ROUTER_CONFIGURATION.md](ER605_ROUTER_CONFIGURATION.md)** ⭐⭐ - Router configuration guide
 - **[CHAIN138_BESU_CONFIGURATION.md](../06-besu/CHAIN138_BESU_CONFIGURATION.md)** ⭐⭐⭐ - Besu configuration guide
 - **[CLOUDFLARE_ROUTING_MASTER.md](../05-network/CLOUDFLARE_ROUTING_MASTER.md)** ⭐⭐⭐ - Cloudflare routing reference
--- a/docs/04-configuration/ENV_SECRETS_AUDIT_REPORT.md
+++ b/docs/04-configuration/ENV_SECRETS_AUDIT_REPORT.md
@@ -338,9 +338,9 @@ Based on documentation and script analysis, these secrets may be needed but not

 ## Related Documentation

- [Required Secrets Inventory](./REQUIRED_SECRETS_INVENTORY.md)
- [Cloudflare API Setup](../CLOUDFLARE_API_SETUP.md)
- [Secrets and Keys Configuration](./SECRETS_KEYS_CONFIGURATION.md)
+- [Required Secrets Inventory](REQUIRED_SECRETS_INVENTORY.md)
+- [Cloudflare API Setup](CLOUDFLARE_API_SETUP.md)
+- [Secrets and Keys Configuration](SECRETS_KEYS_CONFIGURATION.md)

 ---

--- a/docs/04-configuration/MANUAL_STEPS_EXECUTION_COMPLETE.md
+++ b/docs/04-configuration/MANUAL_STEPS_EXECUTION_COMPLETE.md
@@ -274,9 +274,9 @@ find . -name ".env.backup*" -type f | grep -v node_modules
 ## Related Documentation

 - [Secure Secrets Migration Guide](./SECURE_SECRETS_MIGRATION_GUIDE.md)
- [Security Improvements Complete](./SECURITY_IMPROVEMENTS_COMPLETE.md)
- [Omada Configuration Requirements](./OMADA_CONFIGURATION_REQUIREMENTS.md)
- [Required Secrets Inventory](./REQUIRED_SECRETS_INVENTORY.md)
+- [Security Improvements Complete](SECURITY_IMPROVEMENTS_COMPLETE.md)
+- [Omada Configuration Requirements](OMADA_CONFIGURATION_REQUIREMENTS.md)
+- [Required Secrets Inventory](REQUIRED_SECRETS_INVENTORY.md)

 ---

--- a/docs/04-configuration/MCP_SETUP.md
+++ b/docs/04-configuration/MCP_SETUP.md
@@ -154,7 +154,7 @@ The Proxmox MCP server provides 55+ tools for interacting with Proxmox, includin
 - Network management
 - And much more...

-See the [mcp-proxmox README](mcp-proxmox/README.md) for the complete list of available tools.
+See the [mcp-proxmox README](/docs/01-getting-started/README.md) for the complete list of available tools.

 ## Troubleshooting

--- a/docs/04-configuration/OMADA_CONFIGURATION_REQUIREMENTS.md
+++ b/docs/04-configuration/OMADA_CONFIGURATION_REQUIREMENTS.md
@@ -109,7 +109,7 @@ Based on the current `.env` file:

 - Omada Controller API documentation
 - Omada Cloud Controller documentation
- [Required Secrets Inventory](./REQUIRED_SECRETS_INVENTORY.md)
+- [Required Secrets Inventory](REQUIRED_SECRETS_INVENTORY.md)

 ---

--- a/docs/04-configuration/OMADA_CONNECTION_GUIDE.md
+++ b/docs/04-configuration/OMADA_CONNECTION_GUIDE.md
@@ -248,7 +248,7 @@ Once connected, verify:
 - **[OMADA_HARDWARE_CONFIGURATION_REVIEW.md](OMADA_HARDWARE_CONFIGURATION_REVIEW.md)** - Hardware and configuration review
 - **[OMADA_API_SETUP.md](OMADA_API_SETUP.md)** - API integration setup
 - **[ER605_ROUTER_CONFIGURATION.md](ER605_ROUTER_CONFIGURATION.md)** - Router configuration guide
- **[OMADA_AUTH_NOTE.md](../../OMADA_AUTH_NOTE.md)** - Authentication notes
+- **[OMADA_AUTH_NOTE.md](/docs/11-references/OMADA_AUTH_NOTE.md)** - Authentication notes

 ---

--- a/docs/04-configuration/PROXMOX_ACME_QUICK_REFERENCE.md
+++ b/docs/04-configuration/PROXMOX_ACME_QUICK_REFERENCE.md
@@ -160,7 +160,7 @@ openssl x509 -in /etc/pve/nodes/<node>/pve-ssl.pem -noout -dates

 ## Useful Links

- [Full Plan Document](./PROXMOX_ACME_CLOUDFLARE_PLAN.md)
+- [Full Plan Document](PROXMOX_ACME_CLOUDFLARE_PLAN.md)
 - [Domain Inventory Template](./PROXMOX_ACME_DOMAIN_INVENTORY.md)
 - [Proxmox ACME Docs](https://pve.proxmox.com/pve-docs/pve-admin-guide.html#sysadmin_certificate_management)
 - [Cloudflare API Docs](https://developers.cloudflare.com/api/)
--- a/docs/04-configuration/README.md
+++ b/docs/04-configuration/README.md
@@ -10,7 +10,7 @@ This directory contains setup and configuration guides.
 - **[SECRETS_KEYS_CONFIGURATION.md](SECRETS_KEYS_CONFIGURATION.md)** ⭐⭐ - Secrets and keys management
 - **[SSH_SETUP.md](SSH_SETUP.md)** ⭐ - SSH key setup and configuration
 - **[FINALIZE_TOKEN.md](FINALIZE_TOKEN.md)** ⭐ - Token finalization guide
- **[cloudflare/](cloudflare/)** ⭐⭐⭐ - Cloudflare configuration documentation
+- **[cloudflare/](cloudflare)** ⭐⭐⭐ - Cloudflare configuration documentation
 - **[ER605_ROUTER_CONFIGURATION.md](ER605_ROUTER_CONFIGURATION.md)** ⭐⭐ - ER605 router configuration
 - **[OMADA_API_SETUP.md](OMADA_API_SETUP.md)** ⭐⭐ - Omada API integration setup
 - **[OMADA_HARDWARE_CONFIGURATION_REVIEW.md](OMADA_HARDWARE_CONFIGURATION_REVIEW.md)** ⭐⭐⭐ - Comprehensive Omada hardware and configuration review
--- a/docs/04-configuration/REQUIRED_SECRETS_INVENTORY.md
+++ b/docs/04-configuration/REQUIRED_SECRETS_INVENTORY.md
@@ -317,9 +317,9 @@ This document provides a comprehensive inventory of all required secrets and env

 ## Related Documentation

- [Cloudflare API Setup](../CLOUDFLARE_API_SETUP.md)
+- [Cloudflare API Setup](CLOUDFLARE_API_SETUP.md)
 - [Physical Hardware Inventory](../../docs/02-architecture/PHYSICAL_HARDWARE_INVENTORY.md)
- [Proxmox ACME Plan](./PROXMOX_ACME_CLOUDFLARE_PLAN.md)
+- [Proxmox ACME Plan](PROXMOX_ACME_CLOUDFLARE_PLAN.md)
 - [Domain Structure](../../docs/02-architecture/DOMAIN_STRUCTURE.md)

 ---
--- a/docs/04-configuration/REQUIRED_SECRETS_SUMMARY.md
+++ b/docs/04-configuration/REQUIRED_SECRETS_SUMMARY.md
@@ -144,10 +144,10 @@ find . -name ".env*" -type f | grep -v node_modules | grep -v venv

 ## Related Documentation

- [Required Secrets Inventory](./REQUIRED_SECRETS_INVENTORY.md) - Comprehensive inventory
- [Environment Secrets Audit Report](./ENV_SECRETS_AUDIT_REPORT.md) - Detailed audit
- [Cloudflare API Setup](../CLOUDFLARE_API_SETUP.md) - Cloudflare configuration
- [Secrets and Keys Configuration](./SECRETS_KEYS_CONFIGURATION.md) - Security guide
+- [Required Secrets Inventory](REQUIRED_SECRETS_INVENTORY.md) - Comprehensive inventory
+- [Environment Secrets Audit Report](ENV_SECRETS_AUDIT_REPORT.md) - Detailed audit
+- [Cloudflare API Setup](CLOUDFLARE_API_SETUP.md) - Cloudflare configuration
+- [Secrets and Keys Configuration](SECRETS_KEYS_CONFIGURATION.md) - Security guide

 ---

--- a/docs/04-configuration/SECURITY_IMPROVEMENTS_COMPLETE.md
+++ b/docs/04-configuration/SECURITY_IMPROVEMENTS_COMPLETE.md
@@ -338,9 +338,9 @@ sed -i 's/^PRIVATE_KEY=/#PRIVATE_KEY=/' explorer-monorepo/.env

 ## Related Documentation

- [Required Secrets Inventory](./REQUIRED_SECRETS_INVENTORY.md)
- [Environment Secrets Audit Report](./ENV_SECRETS_AUDIT_REPORT.md)
- [Required Secrets Summary](./REQUIRED_SECRETS_SUMMARY.md)
+- [Required Secrets Inventory](REQUIRED_SECRETS_INVENTORY.md)
+- [Environment Secrets Audit Report](ENV_SECRETS_AUDIT_REPORT.md)
+- [Required Secrets Summary](REQUIRED_SECRETS_SUMMARY.md)
 - [Secure Secrets Migration Guide](./SECURE_SECRETS_MIGRATION_GUIDE.md)

 ---
--- a/docs/04-configuration/cloudflare/CLOUDFLARE_TUNNEL_QUICK_SETUP.md
+++ b/docs/04-configuration/cloudflare/CLOUDFLARE_TUNNEL_QUICK_SETUP.md
@@ -247,6 +247,6 @@ Internet → Cloudflare DNS → Cloudflare Tunnel → cloudflared (VMID 102)
 ## Related Documentation

 - [CLOUDFLARE_TUNNEL_RPC_SETUP.md](CLOUDFLARE_TUNNEL_RPC_SETUP.md) - Detailed setup guide
- [RPC_DNS_CONFIGURATION.md](RPC_DNS_CONFIGURATION.md) - Direct DNS configuration
+- [RPC_DNS_CONFIGURATION.md](/docs/04-configuration/RPC_DNS_CONFIGURATION.md) - Direct DNS configuration
 - [CLOUDFLARE_DNS_TO_CONTAINERS.md](CLOUDFLARE_DNS_TO_CONTAINERS.md) - General tunnel guide

--- a/docs/04-configuration/cloudflare/CLOUDFLARE_TUNNEL_RPC_SETUP.md
+++ b/docs/04-configuration/cloudflare/CLOUDFLARE_TUNNEL_RPC_SETUP.md
@@ -513,7 +513,7 @@ rpc-ws-prv.d-bis.org → CNAME → <tunnel-id>.cfargotunnel.com (🟠 Proxied)

 ## Related Documentation

- [RPC_DNS_CONFIGURATION.md](RPC_DNS_CONFIGURATION.md) - Direct DNS configuration
+- [RPC_DNS_CONFIGURATION.md](/docs/04-configuration/RPC_DNS_CONFIGURATION.md) - Direct DNS configuration
 - [CLOUDFLARE_DNS_TO_CONTAINERS.md](CLOUDFLARE_DNS_TO_CONTAINERS.md) - General tunnel setup
 - [CLOUDFLARE_NGINX_INTEGRATION.md](../05-network/CLOUDFLARE_NGINX_INTEGRATION.md) - Nginx integration

--- a/docs/04-configuration/cloudflare/README.md
+++ b/docs/04-configuration/cloudflare/README.md
@@ -58,7 +58,7 @@ This directory contains all Cloudflare-related configuration documentation, incl

 ## Related Documentation

- **[../README.md](../README.md)** - Configuration directory overview
+- **[../README.md](/docs/01-getting-started/README.md)** - Configuration directory overview
 - **[../../05-network/CLOUDFLARE_NGINX_INTEGRATION.md](../../05-network/CLOUDFLARE_NGINX_INTEGRATION.md)** - NGINX integration
 - **[../../05-network/CLOUDFLARE_TUNNEL_ROUTING_ARCHITECTURE.md](../../05-network/CLOUDFLARE_TUNNEL_ROUTING_ARCHITECTURE.md)** - Routing architecture
 - **[../../02-architecture/NETWORK_ARCHITECTURE.md](../../02-architecture/NETWORK_ARCHITECTURE.md)** - Network architecture
--- a/docs/05-network/CLOUDFLARE_ROUTING_MASTER.md
+++ b/docs/05-network/CLOUDFLARE_ROUTING_MASTER.md
@@ -1,6 +1,6 @@
 # Cloudflare Routing Master Reference

-**Navigation:** [Home](../README.md) > [Network](../05-network/README.md) > Cloudflare Routing Master
+**Navigation:** [Home](/docs/01-getting-started/README.md) > [Network](/docs/01-getting-started/README.md) > Cloudflare Routing Master

 **Last Updated:** 2025-01-20  
 **Document Version:** 1.0  
@@ -96,7 +96,7 @@ WebSocket endpoints route **directly** to RPC nodes, bypassing the central Nginx

 ### Domain and DNS
 - **[../02-architecture/DOMAIN_STRUCTURE.md](../02-architecture/DOMAIN_STRUCTURE.md)** ⭐⭐ - Domain structure reference
- **[../04-configuration/RPC_DNS_CONFIGURATION.md](../04-configuration/RPC_DNS_CONFIGURATION.md)** - RPC DNS configuration
+- **[../04-configuration/RPC_DNS_CONFIGURATION.md](/docs/04-configuration/RPC_DNS_CONFIGURATION.md)** - RPC DNS configuration
 - **[../04-configuration/cloudflare/CLOUDFLARE_DNS_SPECIFIC_SERVICES.md](../04-configuration/cloudflare/CLOUDFLARE_DNS_SPECIFIC_SERVICES.md)** ⭐⭐⭐ - Service-specific DNS configuration

 ---
--- a/docs/05-network/CLOUDFLARE_TUNNEL_ROUTING_ARCHITECTURE.md
+++ b/docs/05-network/CLOUDFLARE_TUNNEL_ROUTING_ARCHITECTURE.md
@@ -227,7 +227,7 @@ Update directly in Cloudflare dashboard (tunnel configuration) - no Nginx change

 ### Domain and DNS
 - **[../02-architecture/DOMAIN_STRUCTURE.md](../02-architecture/DOMAIN_STRUCTURE.md)** ⭐⭐ - Domain structure reference
- **[../04-configuration/RPC_DNS_CONFIGURATION.md](../04-configuration/RPC_DNS_CONFIGURATION.md)** - RPC DNS configuration
+- **[../04-configuration/RPC_DNS_CONFIGURATION.md](/docs/04-configuration/RPC_DNS_CONFIGURATION.md)** - RPC DNS configuration
 - **[../04-configuration/cloudflare/CLOUDFLARE_DNS_SPECIFIC_SERVICES.md](../04-configuration/cloudflare/CLOUDFLARE_DNS_SPECIFIC_SERVICES.md)** ⭐⭐⭐ - Service-specific DNS configuration

 ---
--- a/docs/05-network/NGINX_SETUP_FINAL_SUMMARY.md
+++ b/docs/05-network/NGINX_SETUP_FINAL_SUMMARY.md
@@ -209,7 +209,7 @@ All documentation has been created:

 - **[NGINX_ARCHITECTURE_RPC.md](NGINX_ARCHITECTURE_RPC.md)** ⭐⭐⭐ - Complete NGINX architecture for RPC nodes
 - **[RPC_2500_CONFIGURATION_SUMMARY.md](RPC_2500_CONFIGURATION_SUMMARY.md)** - RPC 2500 configuration
- **[../09-troubleshooting/RPC_2500_TROUBLESHOOTING.md](../09-troubleshooting/RPC_2500_TROUBLESHOOTING.md)** - RPC troubleshooting
+- **[../09-troubleshooting/RPC_2500_TROUBLESHOOTING.md](/docs/09-troubleshooting/RPC_2500_TROUBLESHOOTING.md)** - RPC troubleshooting

 ---

--- a/docs/05-network/README.md
+++ b/docs/05-network/README.md
@@ -20,6 +20,6 @@ This directory contains network infrastructure documentation.
 ## Related Documentation

 - **[../02-architecture/NETWORK_ARCHITECTURE.md](../02-architecture/NETWORK_ARCHITECTURE.md)** - Complete network architecture
- **[../04-configuration/ER605_ROUTER_CONFIGURATION.md](../04-configuration/ER605_ROUTER_CONFIGURATION.md)** - Router configuration
+- **[../04-configuration/ER605_ROUTER_CONFIGURATION.md](/docs/04-configuration/ER605_ROUTER_CONFIGURATION.md)** - Router configuration
 - **[../04-configuration/CLOUDFLARE_ZERO_TRUST_GUIDE.md](../04-configuration/CLOUDFLARE_ZERO_TRUST_GUIDE.md)** - Cloudflare setup

--- a/docs/05-network/RPC_2500_CONFIGURATION_SUMMARY.md
+++ b/docs/05-network/RPC_2500_CONFIGURATION_SUMMARY.md
@@ -146,7 +146,7 @@ curl -X POST http://192.168.11.250:8545 \

 - [RPC 2500 Local Nodes Only](./RPC_2500_LOCAL_NODES_ONLY.md)
 - [RPC Node Types Architecture](./RPC_NODE_TYPES_ARCHITECTURE.md)
- [RPC 2500 Troubleshooting](../09-troubleshooting/RPC_2500_TROUBLESHOOTING.md)
+- [RPC 2500 Troubleshooting](/docs/09-troubleshooting/RPC_2500_TROUBLESHOOTING.md)
 - [Besu Allowlist Runbook](../06-besu/BESU_ALLOWLIST_RUNBOOK.md)

 ---
--- a/docs/05-network/RPC_2500_LOCAL_NODES_ONLY.md
+++ b/docs/05-network/RPC_2500_LOCAL_NODES_ONLY.md
@@ -124,7 +124,7 @@ curl -X POST http://192.168.11.250:8545 \

 - [RPC Node Types Architecture](./RPC_NODE_TYPES_ARCHITECTURE.md)
 - [Besu Allowlist Runbook](../06-besu/BESU_ALLOWLIST_RUNBOOK.md)
- [RPC 2500 Troubleshooting](../09-troubleshooting/RPC_2500_TROUBLESHOOTING.md)
+- [RPC 2500 Troubleshooting](/docs/09-troubleshooting/RPC_2500_TROUBLESHOOTING.md)

 ---

--- a/docs/05-network/RPC_PUBLIC_ENDPOINT_ROUTING.md
+++ b/docs/05-network/RPC_PUBLIC_ENDPOINT_ROUTING.md
@@ -282,11 +282,11 @@ Then send:
 - **[RPC_NODE_TYPES_ARCHITECTURE.md](RPC_NODE_TYPES_ARCHITECTURE.md)** ⭐⭐ - RPC node types

 ### Configuration Documents
- **[../04-configuration/RPC_DNS_CONFIGURATION.md](../04-configuration/RPC_DNS_CONFIGURATION.md)** - RPC DNS configuration
+- **[../04-configuration/RPC_DNS_CONFIGURATION.md](/docs/04-configuration/RPC_DNS_CONFIGURATION.md)** - RPC DNS configuration
 - **[../04-configuration/cloudflare/CLOUDFLARE_DNS_TO_CONTAINERS.md](../04-configuration/cloudflare/CLOUDFLARE_DNS_TO_CONTAINERS.md)** - DNS mapping to containers

 ### Troubleshooting
- **[../09-troubleshooting/METAMASK_TROUBLESHOOTING_GUIDE.md](../09-troubleshooting/METAMASK_TROUBLESHOOTING_GUIDE.md)** - MetaMask troubleshooting
+- **[../09-troubleshooting/METAMASK_TROUBLESHOOTING_GUIDE.md](/docs/09-troubleshooting/METAMASK_TROUBLESHOOTING_GUIDE.md)** - MetaMask troubleshooting

 ---

@@ -294,7 +294,7 @@ Then send:
 **Document Version:** 1.0  
 **Review Cycle:** Quarterly
 - [Cloudflare Tunnel RPC Setup](./04-configuration/CLOUDFLARE_TUNNEL_RPC_SETUP.md)
- [RPC JWT Authentication](./04-configuration/RPC_JWT_AUTHENTICATION.md)
+- [RPC JWT Authentication](/docs/04-configuration/RPC_JWT_AUTHENTICATION.md)

 ---

--- a/docs/06-besu/README.md
+++ b/docs/06-besu/README.md
@@ -21,11 +21,11 @@ This directory contains Besu configuration and blockchain operations documentati

 **Validator Keys:**
 - VALIDATOR_KEY_DETAILS.md - Key management
- See also: [../04-configuration/SECRETS_KEYS_CONFIGURATION.md](../04-configuration/SECRETS_KEYS_CONFIGURATION.md)
+- See also: [../04-configuration/SECRETS_KEYS_CONFIGURATION.md](/docs/04-configuration/SECRETS_KEYS_CONFIGURATION.md)

 ## Related Documentation

- **[../09-troubleshooting/QBFT_TROUBLESHOOTING.md](../09-troubleshooting/QBFT_TROUBLESHOOTING.md)** - QBFT troubleshooting
- **[../09-troubleshooting/TROUBLESHOOTING_FAQ.md](../09-troubleshooting/TROUBLESHOOTING_FAQ.md)** - Common issues
+- **[../09-troubleshooting/QBFT_TROUBLESHOOTING.md](/docs/09-troubleshooting/QBFT_TROUBLESHOOTING.md)** - QBFT troubleshooting
+- **[../09-troubleshooting/TROUBLESHOOTING_FAQ.md](/docs/09-troubleshooting/TROUBLESHOOTING_FAQ.md)** - Common issues
 - **[../03-deployment/OPERATIONAL_RUNBOOKS.md](../03-deployment/OPERATIONAL_RUNBOOKS.md)** - Operational procedures

--- a/docs/07-ccip/CCIP_SENDER_CONTRACT_REFERENCE.md
+++ b/docs/07-ccip/CCIP_SENDER_CONTRACT_REFERENCE.md
@@ -236,7 +236,7 @@ The CCIP Monitor service (VMID 3501) listens to these events and tracks:

 ## 📚 Related Documentation

- [Contract Addresses Reference](./CONTRACT_ADDRESSES_REFERENCE.md)
+- [Contract Addresses Reference](/docs/11-references/CONTRACT_ADDRESSES_REFERENCE.md)
 - [Final Contract Addresses](./FINAL_CONTRACT_ADDRESSES.md)
 - [Cross-Chain Bridge Addresses](./CROSS_CHAIN_BRIDGE_ADDRESSES.md)
 - [Deployed Contracts Final](./DEPLOYED_CONTRACTS_FINAL.md)
--- a/docs/09-troubleshooting/METAMASK_TROUBLESHOOTING_GUIDE.md
+++ b/docs/09-troubleshooting/METAMASK_TROUBLESHOOTING_GUIDE.md
@@ -73,7 +73,7 @@
 3. **Remove and Re-add Network**
   - Settings → Networks → Remove the network
   - Add network again with correct settings
-   - See [Quick Start Guide](./METAMASK_QUICK_START_GUIDE.md)
+   - See [Quick Start Guide](/docs/01-getting-started/METAMASK_QUICK_START_GUIDE.md)

 4. **Clear MetaMask Cache**
   - Settings → Advanced → Reset Account (if needed)
@@ -288,7 +288,7 @@
 **Solutions**:

 1. **Add Network Manually**
-   - See [Quick Start Guide](./METAMASK_QUICK_START_GUIDE.md)
+   - See [Quick Start Guide](/docs/01-getting-started/METAMASK_QUICK_START_GUIDE.md)
   - Ensure all fields are correct

 2. **Programmatic Addition** (For dApps)
@@ -414,7 +414,7 @@ curl -X POST https://rpc-http-pub.d-bis.org \
 ### Resources

 1. **Documentation**:
-   - [Quick Start Guide](./METAMASK_QUICK_START_GUIDE.md)
+   - [Quick Start Guide](/docs/01-getting-started/METAMASK_QUICK_START_GUIDE.md)
   - [Full Integration Requirements](./METAMASK_FULL_INTEGRATION_REQUIREMENTS.md)
   - [Oracle Integration](./METAMASK_ORACLE_INTEGRATION.md)

--- a/docs/09-troubleshooting/RPC_2500_QUICK_FIX.md
+++ b/docs/09-troubleshooting/RPC_2500_QUICK_FIX.md
@@ -163,8 +163,8 @@ pct exec 2500 -- curl -X POST http://localhost:8545 \
 ## 📚 Full Documentation

 For detailed troubleshooting, see:
- [RPC 2500 Troubleshooting Guide](./RPC_2500_TROUBLESHOOTING.md)
- [Troubleshooting FAQ](./TROUBLESHOOTING_FAQ.md)
+- [RPC 2500 Troubleshooting Guide](RPC_2500_TROUBLESHOOTING.md)
+- [Troubleshooting FAQ](TROUBLESHOOTING_FAQ.md)

 ---

--- a/docs/09-troubleshooting/RPC_2500_TROUBLESHOOTING.md
+++ b/docs/09-troubleshooting/RPC_2500_TROUBLESHOOTING.md
@@ -412,9 +412,9 @@ After troubleshooting, verify:

 ## 📚 Related Documentation

- [Besu Configuration Guide](../06-besu/README.md)
+- [Besu Configuration Guide](/docs/01-getting-started/README.md)
 - [RPC Node Types Architecture](../05-network/RPC_NODE_TYPES_ARCHITECTURE.md)
- [Network Troubleshooting](./TROUBLESHOOTING_FAQ.md)
+- [Network Troubleshooting](TROUBLESHOOTING_FAQ.md)
 - [Besu Configuration Issues](../archive/BESU_CONFIGURATION_ISSUE.md)

 ---
--- a/docs/09-troubleshooting/RPC_2500_TROUBLESHOOTING_SUMMARY.md
+++ b/docs/09-troubleshooting/RPC_2500_TROUBLESHOOTING_SUMMARY.md
@@ -141,9 +141,9 @@ curl -X POST http://192.168.11.250:8545 \

 ## 📚 Documentation

- [RPC 2500 Troubleshooting Guide](./RPC_2500_TROUBLESHOOTING.md) - Complete guide
- [RPC 2500 Quick Fix](./RPC_2500_QUICK_FIX.md) - Quick reference
- [Troubleshooting FAQ](./TROUBLESHOOTING_FAQ.md) - General troubleshooting
+- [RPC 2500 Troubleshooting Guide](RPC_2500_TROUBLESHOOTING.md) - Complete guide
+- [RPC 2500 Quick Fix](RPC_2500_QUICK_FIX.md) - Quick reference
+- [Troubleshooting FAQ](TROUBLESHOOTING_FAQ.md) - General troubleshooting

 ---

--- a/docs/10-best-practices/PERFORMANCE_TUNING.md
+++ b/docs/10-best-practices/PERFORMANCE_TUNING.md
@@ -310,7 +310,7 @@ This guide provides performance tuning recommendations for Proxmox infrastructur
 ## Related Documentation

 - **[MONITORING_SUMMARY.md](../08-monitoring/MONITORING_SUMMARY.md)** - Monitoring setup
- **[TROUBLESHOOTING_FAQ.md](../09-troubleshooting/TROUBLESHOOTING_FAQ.md)** - Troubleshooting
+- **[TROUBLESHOOTING_FAQ.md](/docs/09-troubleshooting/TROUBLESHOOTING_FAQ.md)** - Troubleshooting
 - **[RECOMMENDATIONS_AND_SUGGESTIONS.md](RECOMMENDATIONS_AND_SUGGESTIONS.md)** - Best practices

 ---
--- a/docs/10-best-practices/SERVICE_STATE_MACHINE.md
+++ b/docs/10-best-practices/SERVICE_STATE_MACHINE.md
@@ -341,7 +341,7 @@ systemctl start <service>
 ## Related Documentation

 - **[OPERATIONAL_RUNBOOKS.md](../03-deployment/OPERATIONAL_RUNBOOKS.md)** ⭐⭐ - Operational procedures
- **[TROUBLESHOOTING_FAQ.md](../09-troubleshooting/TROUBLESHOOTING_FAQ.md)** ⭐⭐⭐ - Troubleshooting guide
+- **[TROUBLESHOOTING_FAQ.md](/docs/09-troubleshooting/TROUBLESHOOTING_FAQ.md)** ⭐⭐⭐ - Troubleshooting guide
 - **[BESU_NODE_STARTUP_SEQUENCE.md](../06-besu/BESU_NODE_STARTUP_SEQUENCE.md)** ⭐ - Besu startup sequence

 ---
--- a/docs/11-references/README.md
+++ b/docs/11-references/README.md
@@ -21,6 +21,6 @@ This directory contains technical reference documentation.

 ## Related Documentation

- **[../01-getting-started/PREREQUISITES.md](../01-getting-started/PREREQUISITES.md)** - Prerequisites
+- **[../01-getting-started/PREREQUISITES.md](/docs/01-getting-started/PREREQUISITES.md)** - Prerequisites
 - **[../12-quick-reference/](../12-quick-reference/)** - Quick reference guides

--- a/docs/11-references/TOKEN_LIST_AUTHORING_GUIDE.md
+++ b/docs/11-references/TOKEN_LIST_AUTHORING_GUIDE.md
@@ -390,7 +390,7 @@ Our token list currently includes:

 ## 🔗 Related Documentation

- [Token Lists README](../token-lists/README.md) - Main token lists documentation
+- [Token Lists README](/docs/01-getting-started/README.md) - Main token lists documentation
 - [Token List Policy](../token-lists/docs/TOKEN_LIST_POLICY.md) - Inclusion and delisting policy
 - [Integration Guide](../token-lists/docs/INTEGRATION_GUIDE.md) - Integration instructions
 - [Uniswap Token Lists Specification](https://github.com/Uniswap/token-lists)
--- a/docs/12-quick-reference/TROUBLESHOOTING_QUICK_REFERENCE.md
+++ b/docs/12-quick-reference/TROUBLESHOOTING_QUICK_REFERENCE.md
@@ -187,7 +187,7 @@ pct restart 102

 ## Related Documentation

- **[../09-troubleshooting/TROUBLESHOOTING_FAQ.md](../09-troubleshooting/TROUBLESHOOTING_FAQ.md)** ⭐⭐⭐ - Complete troubleshooting FAQ
+- **[../09-troubleshooting/TROUBLESHOOTING_FAQ.md](/docs/09-troubleshooting/TROUBLESHOOTING_FAQ.md)** ⭐⭐⭐ - Complete troubleshooting FAQ
 - **[../09-troubleshooting/TROUBLESHOOTING_DECISION_TREE.md](../09-troubleshooting/TROUBLESHOOTING_DECISION_TREE.md)** ⭐⭐ - Troubleshooting decision tree
 - **[../03-deployment/OPERATIONAL_RUNBOOKS.md](../03-deployment/OPERATIONAL_RUNBOOKS.md)** ⭐⭐ - Operational runbooks

--- a/docs/CONTRIBUTOR_GUIDELINES.md
+++ b/docs/CONTRIBUTOR_GUIDELINES.md
@@ -114,7 +114,7 @@ This document provides guidelines for contributing to the documentation, includi
 ```markdown
 # Document Title

-**Navigation:** [Home](../README.md) > [Category](README.md) > Document Title
+**Navigation:** [Home](01-getting-started/README.md) > [Category](01-getting-started/README.md) > Document Title

 **Last Updated:** YYYY-MM-DD  
 **Document Version:** 1.0  
--- a/docs/DOCUMENTATION_RELATIONSHIP_MAP.md
+++ b/docs/DOCUMENTATION_RELATIONSHIP_MAP.md
@@ -225,7 +225,7 @@ Quick Reference Cards

 - **[MASTER_INDEX.md](MASTER_INDEX.md)** ⭐⭐⭐ - Complete documentation index
 - **[DOCUMENTATION_STYLE_GUIDE.md](DOCUMENTATION_STYLE_GUIDE.md)** ⭐⭐⭐ - Documentation standards
- **[README.md](README.md)** ⭐⭐ - Documentation overview
+- **[README.md](01-getting-started/README.md)** ⭐⭐ - Documentation overview

 ---

--- a/docs/DOCUMENTATION_STYLE_GUIDE.md
+++ b/docs/DOCUMENTATION_STYLE_GUIDE.md
@@ -258,7 +258,7 @@ For network architecture details, see **[NETWORK_ARCHITECTURE.md](../02-architec

 See also:
 - **[DEPLOYMENT_GUIDE.md](DEPLOYMENT_GUIDE.md)** - Deployment procedures
- **[TROUBLESHOOTING_FAQ.md](../09-troubleshooting/TROUBLESHOOTING_FAQ.md)** - Troubleshooting
+- **[TROUBLESHOOTING_FAQ.md](09-troubleshooting/TROUBLESHOOTING_FAQ.md)** - Troubleshooting
 ```

 ### Related Documentation Section
@@ -372,7 +372,7 @@ nano /etc/network/interfaces
 ## Related Documentation

 - **[NETWORK_ARCHITECTURE.md](../02-architecture/NETWORK_ARCHITECTURE.md)** - Network architecture
- **[TROUBLESHOOTING_FAQ.md](../09-troubleshooting/TROUBLESHOOTING_FAQ.md)** - Troubleshooting
+- **[TROUBLESHOOTING_FAQ.md](09-troubleshooting/TROUBLESHOOTING_FAQ.md)** - Troubleshooting

 ---

--- a/docs/DOCUMENTATION_UPGRADE_SUMMARY.md
+++ b/docs/DOCUMENTATION_UPGRADE_SUMMARY.md
@@ -67,7 +67,7 @@ This document summarizes the comprehensive documentation consolidation and upgra
 ### 4. Router Configuration Guide ✅

 **Created:**
- **[ER605_ROUTER_CONFIGURATION.md](ER605_ROUTER_CONFIGURATION.md)** - Complete ER605 configuration guide
+- **[ER605_ROUTER_CONFIGURATION.md](04-configuration/ER605_ROUTER_CONFIGURATION.md)** - Complete ER605 configuration guide

 **Contents:**
 - Dual router roles (ER605-A primary, ER605-B standby)
@@ -154,7 +154,7 @@ This document summarizes the comprehensive documentation consolidation and upgra

 1. **[MASTER_INDEX.md](MASTER_INDEX.md)** - Master documentation index
 2. **[ORCHESTRATION_DEPLOYMENT_GUIDE.md](ORCHESTRATION_DEPLOYMENT_GUIDE.md)** - Enterprise deployment guide
-3. **[ER605_ROUTER_CONFIGURATION.md](ER605_ROUTER_CONFIGURATION.md)** - Router configuration
+3. **[ER605_ROUTER_CONFIGURATION.md](04-configuration/ER605_ROUTER_CONFIGURATION.md)** - Router configuration
 4. **[CLOUDFLARE_ZERO_TRUST_GUIDE.md](CLOUDFLARE_ZERO_TRUST_GUIDE.md)** - Cloudflare setup
 5. **[IMPLEMENTATION_CHECKLIST.md](IMPLEMENTATION_CHECKLIST.md)** - Recommendations checklist
 6. **[OPERATIONAL_RUNBOOKS.md](OPERATIONAL_RUNBOOKS.md)** - Master runbook index
@@ -165,7 +165,7 @@ This document summarizes the comprehensive documentation consolidation and upgra

 1. **[NETWORK_ARCHITECTURE.md](NETWORK_ARCHITECTURE.md)** - Complete rewrite (v1.0 → v2.0)
 2. **[CCIP_DEPLOYMENT_SPEC.md](CCIP_DEPLOYMENT_SPEC.md)** - Added VLAN and NAT pool sections
-3. **[docs/README.md](README.md)** - Updated to reference master index
+3. **[docs/README.md](01-getting-started/README.md)** - Updated to reference master index

 ---

@@ -308,7 +308,7 @@ This document summarizes the comprehensive documentation consolidation and upgra
 - **[MASTER_INDEX.md](MASTER_INDEX.md)** - Start here for all documentation
 - **[ORCHESTRATION_DEPLOYMENT_GUIDE.md](ORCHESTRATION_DEPLOYMENT_GUIDE.md)** - Complete deployment guide
 - **[NETWORK_ARCHITECTURE.md](NETWORK_ARCHITECTURE.md)** - Network architecture (v2.0)
- **[ER605_ROUTER_CONFIGURATION.md](ER605_ROUTER_CONFIGURATION.md)** - Router configuration
+- **[ER605_ROUTER_CONFIGURATION.md](04-configuration/ER605_ROUTER_CONFIGURATION.md)** - Router configuration
 - **[CLOUDFLARE_ZERO_TRUST_GUIDE.md](CLOUDFLARE_ZERO_TRUST_GUIDE.md)** - Cloudflare setup
 - **[IMPLEMENTATION_CHECKLIST.md](IMPLEMENTATION_CHECKLIST.md)** - Recommendations checklist
 - **[OPERATIONAL_RUNBOOKS.md](OPERATIONAL_RUNBOOKS.md)** - Runbook index
--- a/docs/MASTER_INDEX.md
+++ b/docs/MASTER_INDEX.md
@@ -446,7 +446,7 @@ docs/
 - **[DOCUMENTATION_ENHANCEMENTS_RECOMMENDATIONS.md](DOCUMENTATION_ENHANCEMENTS_RECOMMENDATIONS.md)** ⭐⭐⭐ - Enhancement recommendations and visual elements
 - **[CLEANUP_SUMMARY.md](CLEANUP_SUMMARY.md)** - Documentation cleanup summary
 - **[DOCUMENTATION_UPGRADE_SUMMARY.md](DOCUMENTATION_UPGRADE_SUMMARY.md)** - Documentation upgrade summary
- **[archive/README.md](archive/README.md)** - Archived documentation index
+- **[archive/README.md](01-getting-started/README.md)** - Archived documentation index

 ---

--- a/docs/README.md
+++ b/docs/README.md
@@ -139,7 +139,7 @@ Essential architecture and design documents:
 - **[02-architecture/VMID_ALLOCATION_FINAL.md](02-architecture/VMID_ALLOCATION_FINAL.md)** - VMID allocation registry (11,000 VMIDs)
 - **[07-ccip/CCIP_DEPLOYMENT_SPEC.md](07-ccip/CCIP_DEPLOYMENT_SPEC.md)** - CCIP fleet deployment specification

-**See:** [02-architecture/README.md](02-architecture/README.md)
+**See:** [02-architecture/README.md](01-getting-started/README.md)

 ### 🚀 Deployment & Operations

@@ -150,7 +150,7 @@ Deployment guides and operational procedures:
 - **[03-deployment/OPERATIONAL_RUNBOOKS.md](03-deployment/OPERATIONAL_RUNBOOKS.md)** - All operational procedures
 - **[03-deployment/DEPLOYMENT_STATUS_CONSOLIDATED.md](03-deployment/DEPLOYMENT_STATUS_CONSOLIDATED.md)** - Current deployment status

-**See:** [03-deployment/README.md](03-deployment/README.md)
+**See:** [03-deployment/README.md](01-getting-started/README.md)

 ### ⚙️ Configuration & Setup

@@ -162,7 +162,7 @@ Setup and configuration guides:
 - **[04-configuration/ER605_ROUTER_CONFIGURATION.md](04-configuration/ER605_ROUTER_CONFIGURATION.md)** - Router configuration
 - **[04-configuration/CLOUDFLARE_ZERO_TRUST_GUIDE.md](04-configuration/CLOUDFLARE_ZERO_TRUST_GUIDE.md)** - Cloudflare Zero Trust

-**See:** [04-configuration/README.md](04-configuration/README.md)
+**See:** [04-configuration/README.md](01-getting-started/README.md)

 ### 🌐 Network Infrastructure

@@ -173,7 +173,7 @@ Network architecture and configuration:
 - **[04-configuration/CLOUDFLARE_ZERO_TRUST_GUIDE.md](04-configuration/CLOUDFLARE_ZERO_TRUST_GUIDE.md)** - Cloudflare Zero Trust
 - **[05-network/NGINX_ARCHITECTURE_RPC.md](05-network/NGINX_ARCHITECTURE_RPC.md)** - NGINX RPC architecture

-**See:** [05-network/README.md](05-network/README.md)
+**See:** [05-network/README.md](01-getting-started/README.md)

 ### ⛓️ Besu & Blockchain

@@ -184,7 +184,7 @@ Besu configuration and operations:
 - **[06-besu/BESU_NODES_FILE_REFERENCE.md](06-besu/BESU_NODES_FILE_REFERENCE.md)** - Nodes file reference
 - **[09-troubleshooting/QBFT_TROUBLESHOOTING.md](09-troubleshooting/QBFT_TROUBLESHOOTING.md)** - QBFT troubleshooting

-**See:** [06-besu/README.md](06-besu/README.md)
+**See:** [06-besu/README.md](01-getting-started/README.md)

 ### 🔗 CCIP & Chainlink

@@ -193,7 +193,7 @@ CCIP deployment and configuration:
 - **[07-ccip/CCIP_DEPLOYMENT_SPEC.md](07-ccip/CCIP_DEPLOYMENT_SPEC.md)** - CCIP deployment specification
 - **[05-network/RPC_TEMPLATE_TYPES.md](05-network/RPC_TEMPLATE_TYPES.md)** - RPC template types

-**See:** [07-ccip/README.md](07-ccip/README.md)
+**See:** [07-ccip/README.md](01-getting-started/README.md)

 ### 📊 Monitoring & Observability

@@ -202,7 +202,7 @@ Monitoring setup and configuration:
 - **[08-monitoring/MONITORING_SUMMARY.md](08-monitoring/MONITORING_SUMMARY.md)** - Monitoring setup
 - **[08-monitoring/BLOCK_PRODUCTION_MONITORING.md](08-monitoring/BLOCK_PRODUCTION_MONITORING.md)** - Block production monitoring

-**See:** [08-monitoring/README.md](08-monitoring/README.md)
+**See:** [08-monitoring/README.md](01-getting-started/README.md)

 ### 🔧 Troubleshooting

@@ -212,7 +212,7 @@ Troubleshooting guides and FAQs:
 - **[09-troubleshooting/QBFT_TROUBLESHOOTING.md](09-troubleshooting/QBFT_TROUBLESHOOTING.md)** - QBFT consensus troubleshooting
 - **[06-besu/BESU_ALLOWLIST_QUICK_START.md](06-besu/BESU_ALLOWLIST_QUICK_START.md)** - Allowlist troubleshooting

-**See:** [09-troubleshooting/README.md](09-troubleshooting/README.md)
+**See:** [09-troubleshooting/README.md](01-getting-started/README.md)

 ### ✅ Best Practices

@@ -222,7 +222,7 @@ Best practices and recommendations:
 - **[10-best-practices/IMPLEMENTATION_CHECKLIST.md](10-best-practices/IMPLEMENTATION_CHECKLIST.md)** - Implementation checklist
 - **[10-best-practices/BEST_PRACTICES_SUMMARY.md](10-best-practices/BEST_PRACTICES_SUMMARY.md)** - Best practices summary

-**See:** [10-best-practices/README.md](10-best-practices/README.md)
+**See:** [10-best-practices/README.md](01-getting-started/README.md)

 ---

@@ -250,14 +250,14 @@ Best practices and recommendations:

 ### Project Documentation

- **[../README.md](../README.md)** - Main project README
+- **[../README.md](01-getting-started/README.md)** - Main project README
 - **[../PROJECT_STRUCTURE.md](../PROJECT_STRUCTURE.md)** - Project structure

 ### Submodule Documentation

- **[../mcp-proxmox/README.md](../mcp-proxmox/README.md)** - MCP Server documentation
- **[../ProxmoxVE/README.md](../ProxmoxVE/README.md)** - ProxmoxVE scripts documentation
- **[../smom-dbis-138-proxmox/README.md](../smom-dbis-138-proxmox/README.md)** - Deployment scripts documentation
+- **[../mcp-proxmox/README.md](01-getting-started/README.md)** - MCP Server documentation
+- **[../ProxmoxVE/README.md](01-getting-started/README.md)** - ProxmoxVE scripts documentation
+- **[../smom-dbis-138-proxmox/README.md](01-getting-started/README.md)** - Deployment scripts documentation

 ---

--- a/docs/SEARCH_GUIDE.md
+++ b/docs/SEARCH_GUIDE.md
@@ -90,8 +90,8 @@ rg "keyword" -t markdown docs/
 - Specific service names (e.g., "besu", "cloudflare", "nginx")

 **Key Files:**
- [04-configuration/templates/](../04-configuration/templates/) - Configuration templates
- [04-configuration/CONFIGURATION_DECISION_TREE.md](../04-configuration/CONFIGURATION_DECISION_TREE.md) - Configuration decision tree
+- [04-configuration/templates/](04-configuration/templates) - Configuration templates
+- [04-configuration/CONFIGURATION_DECISION_TREE.md](04-configuration/CONFIGURATION_DECISION_TREE.md) - Configuration decision tree

 ---

@@ -104,7 +104,7 @@ rg "keyword" -t markdown docs/
 - Specific error messages

 **Key Files:**
- [09-troubleshooting/TROUBLESHOOTING_FAQ.md](../09-troubleshooting/TROUBLESHOOTING_FAQ.md) - Troubleshooting FAQ
+- [09-troubleshooting/TROUBLESHOOTING_FAQ.md](09-troubleshooting/TROUBLESHOOTING_FAQ.md) - Troubleshooting FAQ
 - [09-troubleshooting/TROUBLESHOOTING_DECISION_TREE.md](../09-troubleshooting/TROUBLESHOOTING_DECISION_TREE.md) - Troubleshooting decision tree

 ---
@@ -165,7 +165,7 @@ cd docs

 - **[SEARCH_INDEX.md](SEARCH_INDEX.md)** ⭐⭐⭐ - Complete searchable index
 - **[MASTER_INDEX.md](MASTER_INDEX.md)** ⭐⭐⭐ - Master documentation index
- **[README.md](README.md)** ⭐⭐ - Documentation overview
+- **[README.md](01-getting-started/README.md)** ⭐⭐ - Documentation overview

 ---

--- a/docs/archive/BESU_CONFIGURATION_ISSUE.md
+++ b/docs/archive/BESU_CONFIGURATION_ISSUE.md
@@ -207,7 +207,7 @@ Dec 20 15:51:XX besu-validator-X systemd[1]: besu-validator.service: Deactivated
 ## Related Documentation

 - [Files Copy Checklist](FILES_COPY_CHECKLIST.md)
- [Path Reference](PATHS_REFERENCE.md)
+- [Path Reference](/docs/11-references/PATHS_REFERENCE.md)
 - [Current Deployment Status](CURRENT_DEPLOYMENT_STATUS.md)

 ---
--- a/docs/archive/ORGANIZATION_SUMMARY.md
+++ b/docs/archive/ORGANIZATION_SUMMARY.md
@@ -81,10 +81,10 @@ All documentation references updated to use `docs/` prefix:

 ```markdown
 # Old way (no longer works)
-See [MCP_SETUP.md](MCP_SETUP.md)
+See [MCP_SETUP.md](/docs/04-configuration/MCP_SETUP.md)

 # New way
-See [docs/MCP_SETUP.md](docs/MCP_SETUP.md)
+See [docs/MCP_SETUP.md](/docs/04-configuration/MCP_SETUP.md)
 ```

 ## Next Steps
--- a/docs/archive/completion/ALI_INFRASTRUCTURE_COMPLETE.md
+++ b/docs/archive/completion/ALI_INFRASTRUCTURE_COMPLETE.md
@@ -932,10 +932,10 @@ xdg-open "https://explorer.d-bis.org/address/0x3304b747e565a97ec8ac220b0b6a1f6ff

 - [ChainID 138 Complete Implementation](CHAIN138_COMPLETE_IMPLEMENTATION.md)
 - [Container Rename and Migration](CHAIN138_CONTAINER_RENAME_MIGRATION.md)
- [Contract Addresses Reference](CONTRACT_ADDRESSES_REFERENCE.md)
+- [Contract Addresses Reference](/docs/11-references/CONTRACT_ADDRESSES_REFERENCE.md)
 - [Besu Configuration Guide](CHAIN138_BESU_CONFIGURATION.md)
 - [Access Control Model](CHAIN138_ACCESS_CONTROL_CORRECTED.md)
- [JWT Authentication Requirements](CHAIN138_JWT_AUTH_REQUIREMENTS.md)
+- [JWT Authentication Requirements](/docs/04-configuration/CHAIN138_JWT_AUTH_REQUIREMENTS.md)

 ---

--- a/docs/archive/completion/ALL_TASKS_COMPLETE_SUMMARY.md
+++ b/docs/archive/completion/ALL_TASKS_COMPLETE_SUMMARY.md
@@ -288,8 +288,8 @@ All infrastructure, scripts, and documentation are in place. The network is oper
 - [Source Project Contract Info](./SOURCE_PROJECT_CONTRACT_DEPLOYMENT_INFO.md)

 ### For Troubleshooting
- [RPC Troubleshooting Guide](./09-troubleshooting/RPC_2500_TROUBLESHOOTING.md)
- [RPC Quick Fix](./09-troubleshooting/RPC_2500_QUICK_FIX.md)
+- [RPC Troubleshooting Guide](/docs/09-troubleshooting/RPC_2500_TROUBLESHOOTING.md)
+- [RPC Quick Fix](/docs/09-troubleshooting/RPC_2500_QUICK_FIX.md)
 - [RPC Troubleshooting Complete](./RPC_TROUBLESHOOTING_COMPLETE.md)

 ### For Service Configuration
--- a/docs/archive/completion/CHAIN138_COMPLETE_FILE_LIST.md
+++ b/docs/archive/completion/CHAIN138_COMPLETE_FILE_LIST.md
@@ -201,7 +201,7 @@ All files are:

 ## 🔗 Related Documentation

- [Quick Start Guide](CHAIN138_QUICK_START.md)
+- [Quick Start Guide](/docs/01-getting-started/CHAIN138_QUICK_START.md)
 - [Configuration Guide](CHAIN138_BESU_CONFIGURATION.md)
 - [Configuration Summary](CHAIN138_CONFIGURATION_SUMMARY.md)

--- a/docs/archive/completion/CHAIN138_COMPLETE_IMPLEMENTATION.md
+++ b/docs/archive/completion/CHAIN138_COMPLETE_IMPLEMENTATION.md
@@ -307,7 +307,7 @@ This will:
 - [ChainID 138 Configuration Guide](CHAIN138_BESU_CONFIGURATION.md)
 - [Configuration Summary](CHAIN138_CONFIGURATION_SUMMARY.md)
 - [Access Control Model](CHAIN138_ACCESS_CONTROL_CORRECTED.md)
- [JWT Authentication Requirements](CHAIN138_JWT_AUTH_REQUIREMENTS.md)
+- [JWT Authentication Requirements](/docs/04-configuration/CHAIN138_JWT_AUTH_REQUIREMENTS.md)

 ---

@@ -316,7 +316,7 @@ This will:
 For detailed information on:
 - **Configuration**: See [CHAIN138_BESU_CONFIGURATION.md](CHAIN138_BESU_CONFIGURATION.md)
 - **Access Control**: See [CHAIN138_ACCESS_CONTROL_CORRECTED.md](CHAIN138_ACCESS_CONTROL_CORRECTED.md)
- **JWT Setup**: See [CHAIN138_JWT_AUTH_REQUIREMENTS.md](CHAIN138_JWT_AUTH_REQUIREMENTS.md)
+- **JWT Setup**: See [CHAIN138_JWT_AUTH_REQUIREMENTS.md](/docs/04-configuration/CHAIN138_JWT_AUTH_REQUIREMENTS.md)
 - **Deployment**: See [CHAIN138_CONFIGURATION_SUMMARY.md](CHAIN138_CONFIGURATION_SUMMARY.md)

 ---
--- a/docs/archive/completion/CHAIN138_REVIEW_COMPLETE.md
+++ b/docs/archive/completion/CHAIN138_REVIEW_COMPLETE.md
@@ -279,7 +279,7 @@ The system is ready for use with currently running containers. New containers ca

 ## 📚 Related Documentation

- [Quick Start Guide](CHAIN138_QUICK_START.md)
+- [Quick Start Guide](/docs/01-getting-started/CHAIN138_QUICK_START.md)
 - [Configuration Guide](CHAIN138_BESU_CONFIGURATION.md)
 - [Configuration Summary](CHAIN138_CONFIGURATION_SUMMARY.md)
 - [Complete File List](CHAIN138_COMPLETE_FILE_LIST.md)
--- a/docs/archive/completion/IP_ADDRESS_REVIEW_COMPLETE.md
+++ b/docs/archive/completion/IP_ADDRESS_REVIEW_COMPLETE.md
@@ -342,9 +342,9 @@ According to `VMID_IP_ADDRESS_LIST.md`, all IP conflicts have been resolved:
 - [Physical Hardware Inventory](../config/physical-hardware-inventory.md) - Quick reference
 - [Physical Hardware Inventory (Comprehensive)](./02-architecture/PHYSICAL_HARDWARE_INVENTORY.md) - Detailed documentation
 - [Omada Cloud Controller IP Assignments](./OMADA_CLOUD_CONTROLLER_IP_ASSIGNMENTS.md) - Public IP assignments
- [VMID and IP Address List](../VMID_IP_ADDRESS_LIST.md) - Complete VMID/IP mapping
+- [VMID and IP Address List](/reports/VMID_IP_ADDRESS_LIST.md) - Complete VMID/IP mapping
 - [Infrastructure Overview Complete](../INFRASTRUCTURE_OVERVIEW_COMPLETE.md) - Comprehensive infrastructure (needs update)
- [VMID IP Conflicts Analysis](../VMID_IP_CONFLICTS_ANALYSIS.md) - Conflict resolution history
+- [VMID IP Conflicts Analysis](/reports/status/VMID_IP_CONFLICTS_ANALYSIS.md) - Conflict resolution history

 ---

--- a/docs/archive/completion/LETS_ENCRYPT_COMPLETE_SUMMARY.md
+++ b/docs/archive/completion/LETS_ENCRYPT_COMPLETE_SUMMARY.md
@@ -169,7 +169,7 @@ The Let's Encrypt certificate has been successfully installed and configured for

 - [Let's Encrypt Setup Success](./LETS_ENCRYPT_SETUP_SUCCESS.md)
 - [Let's Encrypt DNS Setup Required](./LETS_ENCRYPT_DNS_SETUP_REQUIRED.md)
- [Nginx RPC 2500 Configuration](./09-troubleshooting/NGINX_RPC_2500_CONFIGURATION.md)
+- [Nginx RPC 2500 Configuration](/docs/09-troubleshooting/NGINX_RPC_2500_CONFIGURATION.md)
 - [Cloudflare Tunnel RPC Setup](../04-configuration/CLOUDFLARE_TUNNEL_RPC_SETUP.md)

 ---
--- a/docs/archive/completion/LETS_ENCRYPT_RPC_2500_COMPLETE.md
+++ b/docs/archive/completion/LETS_ENCRYPT_RPC_2500_COMPLETE.md
@@ -214,7 +214,7 @@ dig rpc-core.d-bis.org

 - [Let's Encrypt RPC 2500 Guide](./LETS_ENCRYPT_RPC_2500_GUIDE.md)
 - [Let's Encrypt Setup Status](./LETS_ENCRYPT_SETUP_STATUS.md)
- [Nginx RPC 2500 Configuration](./09-troubleshooting/NGINX_RPC_2500_CONFIGURATION.md)
+- [Nginx RPC 2500 Configuration](/docs/09-troubleshooting/NGINX_RPC_2500_CONFIGURATION.md)

 ---

--- a/docs/archive/completion/METAMASK_INTEGRATION_COMPLETE.md
+++ b/docs/archive/completion/METAMASK_INTEGRATION_COMPLETE.md
@@ -227,7 +227,7 @@ bash scripts/test-metamask-integration.sh
 ## 📚 Documentation Index

 ### Getting Started
- [Quick Start Guide](./METAMASK_QUICK_START_GUIDE.md) - 5-minute setup
+- [Quick Start Guide](/docs/01-getting-started/METAMASK_QUICK_START_GUIDE.md) - 5-minute setup
 - [Full Integration Requirements](./METAMASK_FULL_INTEGRATION_REQUIREMENTS.md) - Complete checklist

 ### Integration Guides
@@ -235,11 +235,11 @@ bash scripts/test-metamask-integration.sh
 - [Network Configuration](./METAMASK_NETWORK_CONFIG.json) - Network settings

 ### Troubleshooting
- [Troubleshooting Guide](./METAMASK_TROUBLESHOOTING_GUIDE.md) - Common issues
+- [Troubleshooting Guide](/docs/09-troubleshooting/METAMASK_TROUBLESHOOTING_GUIDE.md) - Common issues
 - [WETH9 Display Fix](./METAMASK_WETH9_FIX_INSTRUCTIONS.md) - Display bug fix

 ### Reference
- [Contract Addresses](./CONTRACT_ADDRESSES_REFERENCE.md) - All addresses
+- [Contract Addresses](/docs/11-references/CONTRACT_ADDRESSES_REFERENCE.md) - All addresses
 - [Token List](./METAMASK_TOKEN_LIST.json) - Token configuration

 ---
--- a/docs/archive/completion/METAMASK_SUBMODULE_SETUP_COMPLETE.md
+++ b/docs/archive/completion/METAMASK_SUBMODULE_SETUP_COMPLETE.md
@@ -152,7 +152,7 @@ git push
 ## 📚 Documentation

 - [Submodule Guide](./METAMASK_SUBMODULE_GUIDE.md) - Complete guide for working with submodule
- [Submodule README](../metamask-integration/README.md) - Submodule documentation
+- [Submodule README](/docs/01-getting-started/README.md) - Submodule documentation

 ---

--- a/docs/archive/completion/NGINX_RPC_2500_COMPLETE_SETUP.md
+++ b/docs/archive/completion/NGINX_RPC_2500_COMPLETE_SETUP.md
@@ -324,7 +324,7 @@ Remove Nginx from RPC nodes, use nginx-proxy-manager directly to Besu.

 ## 📚 Related Documentation

- [Nginx RPC 2500 Configuration](./09-troubleshooting/NGINX_RPC_2500_CONFIGURATION.md)
+- [Nginx RPC 2500 Configuration](/docs/09-troubleshooting/NGINX_RPC_2500_CONFIGURATION.md)
 - [Nginx Architecture for RPC Nodes](../05-network/NGINX_ARCHITECTURE_RPC.md)
 - [RPC Node Types Architecture](../05-network/RPC_NODE_TYPES_ARCHITECTURE.md)
 - [Cloudflare Nginx Integration](../05-network/CLOUDFLARE_NGINX_INTEGRATION.md)
--- a/docs/archive/completion/PROXMOX_PVE_PVE2_FIX_COMPLETE.md
+++ b/docs/archive/completion/PROXMOX_PVE_PVE2_FIX_COMPLETE.md
@@ -193,7 +193,7 @@ ssh root@192.168.11.11 "journalctl -u pveproxy -n 50 | grep 'worker exit'"

 - [Proxmox Issues Analysis](./PROXMOX_PVE_PVE2_ISSUES.md) - Original issue analysis
 - [Hostname Migration Guide](./02-architecture/HOSTNAME_MIGRATION_GUIDE.md) - How to change hostnames
- [R630-04 Troubleshooting](./R630-04-PROXMOX-TROUBLESHOOTING.md) - Similar issues on r630-04
+- [R630-04 Troubleshooting](/docs/09-troubleshooting/R630-04-PROXMOX-TROUBLESHOOTING.md) - Similar issues on r630-04

 ---

--- a/docs/archive/completion/RPC_TROUBLESHOOTING_COMPLETE.md
+++ b/docs/archive/completion/RPC_TROUBLESHOOTING_COMPLETE.md
@@ -210,8 +210,8 @@ pct exec 2500 -- systemctl start besu-rpc.service

 ## 📚 Related Documentation

- [RPC 2500 Troubleshooting Guide](./09-troubleshooting/RPC_2500_TROUBLESHOOTING.md)
- [RPC 2500 Quick Fix](./09-troubleshooting/RPC_2500_QUICK_FIX.md)
+- [RPC 2500 Troubleshooting Guide](/docs/09-troubleshooting/RPC_2500_TROUBLESHOOTING.md)
+- [RPC 2500 Quick Fix](/docs/09-troubleshooting/RPC_2500_QUICK_FIX.md)
 - [Deployment Readiness Checklist](./DEPLOYMENT_READINESS_CHECKLIST.md)

 ---
--- a/docs/archive/configuration/LETS_ENCRYPT_RPC_2500_GUIDE.md
+++ b/docs/archive/configuration/LETS_ENCRYPT_RPC_2500_GUIDE.md
@@ -325,7 +325,7 @@ pct exec 2500 -- certbot --nginx -d rpc-core.yourdomain.com

 ## 📚 Related Documentation

- [Nginx RPC 2500 Configuration](./09-troubleshooting/NGINX_RPC_2500_CONFIGURATION.md)
+- [Nginx RPC 2500 Configuration](/docs/09-troubleshooting/NGINX_RPC_2500_CONFIGURATION.md)
 - [Cloudflare DNS Configuration](./04-configuration/CLOUDFLARE_DNS_SPECIFIC_SERVICES.md)
 - [Cloudflare Tunnel Setup](./04-configuration/CLOUDFLARE_TUNNEL_RPC_SETUP.md)

--- a/docs/archive/configuration/METAMASK_ADD_TOKEN_LIST_GUIDE.md
+++ b/docs/archive/configuration/METAMASK_ADD_TOKEN_LIST_GUIDE.md
@@ -177,16 +177,16 @@ To actually see tokens in your wallet:

 **Solution**: Add ChainID 138 network first:
 1. MetaMask → Add Network
-2. Enter network details (see [Quick Start Guide](./METAMASK_QUICK_START_GUIDE.md))
+2. Enter network details (see [Quick Start Guide](/docs/01-getting-started/METAMASK_QUICK_START_GUIDE.md))
 3. Then add token list

 ---

 ## 📚 Related Documentation

- [MetaMask Quick Start Guide](./METAMASK_QUICK_START_GUIDE.md) - Add ChainID 138 network
+- [MetaMask Quick Start Guide](/docs/01-getting-started/METAMASK_QUICK_START_GUIDE.md) - Add ChainID 138 network
 - [Token List Verification](./METAMASK_CUSTOM_DOMAIN_VERIFICATION.md) - Verify token list is working
- [Troubleshooting Guide](./METAMASK_TROUBLESHOOTING_GUIDE.md) - Common issues and solutions
+- [Troubleshooting Guide](/docs/09-troubleshooting/METAMASK_TROUBLESHOOTING_GUIDE.md) - Common issues and solutions

 ---

--- a/docs/archive/configuration/METAMASK_GITHUB_PAGES_INSTRUCTIONS.md
+++ b/docs/archive/configuration/METAMASK_GITHUB_PAGES_INSTRUCTIONS.md
@@ -165,7 +165,7 @@ After setup, the token list will be:

 - [GitHub Pages Setup Guide](../metamask-integration/docs/GITHUB_PAGES_SETUP.md)
 - [Token List Hosting Guide](./METAMASK_TOKEN_LIST_HOSTING.md)
- [Quick Start Guide](../metamask-integration/docs/METAMASK_QUICK_START_GUIDE.md)
+- [Quick Start Guide](/docs/01-getting-started/METAMASK_QUICK_START_GUIDE.md)

 ---

--- a/docs/archive/configuration/METAMASK_SUBMODULE_GUIDE.md
+++ b/docs/archive/configuration/METAMASK_SUBMODULE_GUIDE.md
@@ -227,8 +227,8 @@ git remote -v
 ## 📚 Related Documentation

 - [MetaMask Integration Complete](../metamask-integration/docs/METAMASK_INTEGRATION_COMPLETE.md)
- [Quick Start Guide](../metamask-integration/docs/METAMASK_QUICK_START_GUIDE.md)
- [Submodule README](../metamask-integration/README.md)
+- [Quick Start Guide](/docs/01-getting-started/METAMASK_QUICK_START_GUIDE.md)
+- [Submodule README](/docs/01-getting-started/README.md)

 ---

--- a/docs/archive/fixes/CHAIN138_ACCESS_CONTROL_CORRECTED.md
+++ b/docs/archive/fixes/CHAIN138_ACCESS_CONTROL_CORRECTED.md
@@ -179,7 +179,7 @@

 - [Missing Containers List](MISSING_CONTAINERS_LIST.md)
 - [ChainID 138 Configuration Guide](CHAIN138_BESU_CONFIGURATION.md)
- [ChainID 138 Quick Start](CHAIN138_QUICK_START.md)
+- [ChainID 138 Quick Start](/docs/01-getting-started/CHAIN138_QUICK_START.md)

 ---

--- a/docs/archive/fixes/METAMASK_RPC_CHAIN_ID_ERROR_FIX.md
+++ b/docs/archive/fixes/METAMASK_RPC_CHAIN_ID_ERROR_FIX.md
@@ -196,10 +196,10 @@ If the error persists, check:

 ## 🔗 Related Documentation

- [MetaMask Quick Start Guide](./METAMASK_QUICK_START_GUIDE.md)
- [MetaMask Troubleshooting Guide](./METAMASK_TROUBLESHOOTING_GUIDE.md)
- [RPC DNS Configuration](../04-configuration/RPC_DNS_CONFIGURATION.md)
- [RPC JWT Authentication](../04-configuration/RPC_JWT_AUTHENTICATION.md)
+- [MetaMask Quick Start Guide](/docs/01-getting-started/METAMASK_QUICK_START_GUIDE.md)
+- [MetaMask Troubleshooting Guide](/docs/09-troubleshooting/METAMASK_TROUBLESHOOTING_GUIDE.md)
+- [RPC DNS Configuration](/docs/04-configuration/RPC_DNS_CONFIGURATION.md)
+- [RPC JWT Authentication](/docs/04-configuration/RPC_JWT_AUTHENTICATION.md)

 ---

--- a/docs/archive/historical/CHAIN138_NEXT_STEPS.md
+++ b/docs/archive/historical/CHAIN138_NEXT_STEPS.md
@@ -436,7 +436,7 @@ cd /home/intlc/projects/proxmox

 - [Missing Containers List](MISSING_CONTAINERS_LIST.md)
 - [ChainID 138 Configuration Guide](CHAIN138_BESU_CONFIGURATION.md)
- [JWT Authentication Requirements](CHAIN138_JWT_AUTH_REQUIREMENTS.md)
+- [JWT Authentication Requirements](/docs/04-configuration/CHAIN138_JWT_AUTH_REQUIREMENTS.md)
 - [Access Control Model](CHAIN138_ACCESS_CONTROL_CORRECTED.md)
 - [Complete Implementation Summary](CHAIN138_COMPLETE_IMPLEMENTATION.md)

--- a/docs/archive/historical/CLEANUP_SUMMARY.md
+++ b/docs/archive/historical/CLEANUP_SUMMARY.md
@@ -190,7 +190,7 @@ All archived documents are available in:
 ## References

 - **[MASTER_INDEX.md](MASTER_INDEX.md)** - Complete documentation index
- **[docs/archive/README.md](archive/README.md)** - Archive documentation
+- **[docs/archive/README.md](/docs/01-getting-started/README.md)** - Archive documentation
 - **[docs/archive/CLEANUP_LOG.md](archive/CLEANUP_LOG.md)** - Detailed cleanup log

 ---
--- a/docs/archive/historical/CONTRACT_ADDRESS_CROSS_CHAIN_NOTE.md
+++ b/docs/archive/historical/CONTRACT_ADDRESS_CROSS_CHAIN_NOTE.md
@@ -128,7 +128,7 @@ RPC_URL=http://192.168.11.250:8545
 ## 🔗 Related Documentation

 - [CCIP Sender Contract Reference](./CCIP_SENDER_CONTRACT_REFERENCE.md)
- [Contract Addresses Reference](./CONTRACT_ADDRESSES_REFERENCE.md)
+- [Contract Addresses Reference](/docs/11-references/CONTRACT_ADDRESSES_REFERENCE.md)
 - [Final Contract Addresses](./FINAL_CONTRACT_ADDRESSES.md)

 ---
--- a/docs/archive/historical/METAMASK_FULL_INTEGRATION_REQUIREMENTS.md
+++ b/docs/archive/historical/METAMASK_FULL_INTEGRATION_REQUIREMENTS.md
@@ -392,7 +392,7 @@ await window.ethereum.request({
 - [MetaMask Network Config](./METAMASK_NETWORK_CONFIG.json)
 - [MetaMask Token List](./METAMASK_TOKEN_LIST.json)
 - [WETH9 Display Bug Fix](./METAMASK_WETH9_FIX_INSTRUCTIONS.md)
- [Contract Addresses Reference](./CONTRACT_ADDRESSES_REFERENCE.md)
+- [Contract Addresses Reference](/docs/11-references/CONTRACT_ADDRESSES_REFERENCE.md)

 ---

--- a/docs/archive/historical/METAMASK_REMAINING_REQUIREMENTS.md
+++ b/docs/archive/historical/METAMASK_REMAINING_REQUIREMENTS.md
@@ -257,7 +257,7 @@ Users can already:

 - [Full Integration Requirements](./METAMASK_FULL_INTEGRATION_REQUIREMENTS.md)
 - [Token List Hosting Guide](./METAMASK_TOKEN_LIST_HOSTING.md)
- [Quick Start Guide](../metamask-integration/docs/METAMASK_QUICK_START_GUIDE.md)
+- [Quick Start Guide](/docs/01-getting-started/METAMASK_QUICK_START_GUIDE.md)

 ---

--- a/docs/archive/historical/METAMASK_WETH9_DISPLAY_BUG.md
+++ b/docs/archive/historical/METAMASK_WETH9_DISPLAY_BUG.md
@@ -180,7 +180,7 @@ If WETH9 cannot be fixed, consider:
 ## 🔗 Related Documentation

 - [WETH9 Creation Analysis](./WETH9_CREATION_ANALYSIS.md)
- [Contract Addresses Reference](./CONTRACT_ADDRESSES_REFERENCE.md)
+- [Contract Addresses Reference](/docs/11-references/CONTRACT_ADDRESSES_REFERENCE.md)
 - [MetaMask Token List](./METAMASK_TOKEN_LIST.json)

 ---
--- a/docs/archive/historical/PROXMOX_PVE_PVE2_ISSUES.md
+++ b/docs/archive/historical/PROXMOX_PVE_PVE2_ISSUES.md
@@ -259,7 +259,7 @@ After applying fixes, verify:

 ## Related Documentation

- [R630-04 Proxmox Troubleshooting](./R630-04-PROXMOX-TROUBLESHOOTING.md) - Similar issues on r630-04
+- [R630-04 Proxmox Troubleshooting](/docs/09-troubleshooting/R630-04-PROXMOX-TROUBLESHOOTING.md) - Similar issues on r630-04
 - [Proxmox Cluster Configuration](./docs/02-architecture/CLUSTER_MIGRATION_PLAN.md) - Cluster setup information

 ---
--- a/docs/archive/status/COMPLETE_PROJECT_STATUS.md
+++ b/docs/archive/status/COMPLETE_PROJECT_STATUS.md
@@ -161,8 +161,8 @@ The MetaMask integration is **100% complete** with:
 ## 📚 Quick Reference

 ### For Users
- Start here: [Quick Start Guide](./METAMASK_QUICK_START_GUIDE.md)
- Issues? See: [Troubleshooting Guide](./METAMASK_TROUBLESHOOTING_GUIDE.md)
+- Start here: [Quick Start Guide](/docs/01-getting-started/METAMASK_QUICK_START_GUIDE.md)
+- Issues? See: [Troubleshooting Guide](/docs/09-troubleshooting/METAMASK_TROUBLESHOOTING_GUIDE.md)

 ### For Developers
 - Requirements: [Full Integration Requirements](./METAMASK_FULL_INTEGRATION_REQUIREMENTS.md)
--- a/docs/archive/status/LETS_ENCRYPT_SETUP_STATUS.md
+++ b/docs/archive/status/LETS_ENCRYPT_SETUP_STATUS.md
@@ -142,7 +142,7 @@ pct exec 2500 -- sed -i 's/server_name.*rpc-core.besu.local.*;/server_name rpc-c
 ## 📚 Documentation

 - [Let's Encrypt RPC 2500 Guide](./LETS_ENCRYPT_RPC_2500_GUIDE.md) - Complete setup guide
- [Nginx RPC 2500 Configuration](./09-troubleshooting/NGINX_RPC_2500_CONFIGURATION.md) - Nginx config
+- [Nginx RPC 2500 Configuration](/docs/09-troubleshooting/NGINX_RPC_2500_CONFIGURATION.md) - Nginx config
 - [Cloudflare DNS Configuration](./04-configuration/CLOUDFLARE_DNS_SPECIFIC_SERVICES.md) - DNS setup

 ---