diff --git a/README.md b/README.md
index 01d2202..62989a1 100644
--- a/README.md
+++ b/README.md
@@ -243,7 +243,7 @@ kubectl port-forward -n warehouse13 svc/warehouse13-api 8000:8000
 
 ### Helm Documentation
 
-- **Full Helm Guide:** [HELM-DEPLOYMENT.md](./HELM-DEPLOYMENT.md)
+- **Full Helm Guide:** [HELM-DEPLOYMENT.md](./docs/HELM-DEPLOYMENT.md)
 - **Chart README:** [helm/warehouse13/README.md](./helm/warehouse13/README.md)
 - **Quick Start:** [helm/warehouse13/QUICKSTART.md](./helm/warehouse13/QUICKSTART.md)
 - **Example Configurations:**
diff --git a/docs/DEPLOYMENT.md b/docs/DEPLOYMENT.md
index f596b5e..2d27e12 100644
--- a/docs/DEPLOYMENT.md
+++ b/docs/DEPLOYMENT.md
@@ -54,7 +54,7 @@ This script will:
 
 ```bash
 # Option A: Use the helper script
-./build-for-airgap.sh
+./scripts/build-for-airgap.sh
 
 # Option B: Build manually
 cd frontend
diff --git a/HELM-DEPLOYMENT.md b/docs/HELM-DEPLOYMENT.md
similarity index 100%
rename from HELM-DEPLOYMENT.md
rename to docs/HELM-DEPLOYMENT.md
diff --git a/helm/README.md b/helm/README.md
index 9b35934..fed3a93 100644
--- a/helm/README.md
+++ b/helm/README.md
@@ -43,4 +43,4 @@ Note: Check your values.yaml configuration and update image repositories, resour
 
 ## Quick Start
 
-See [../HELM-DEPLOYMENT.md](../HELM-DEPLOYMENT.md) for comprehensive deployment guide.
+See [../docs/HELM-DEPLOYMENT.md](../docs/HELM-DEPLOYMENT.md) for comprehensive deployment guide.
diff --git a/helm/warehouse13/QUICKSTART.md b/helm/warehouse13/QUICKSTART.md
index b70e123..1d0cee9 100644
--- a/helm/warehouse13/QUICKSTART.md
+++ b/helm/warehouse13/QUICKSTART.md
@@ -118,7 +118,7 @@ kubectl delete namespace warehouse13
 ## Next Steps
 
 - **Full Documentation:** [README.md](./README.md)
-- **Deployment Guide:** [../../HELM-DEPLOYMENT.md](../../HELM-DEPLOYMENT.md)
+- **Deployment Guide:** [../../docs/HELM-DEPLOYMENT.md](../../docs/HELM-DEPLOYMENT.md)
 - **Configuration Options:** [values.yaml](./values.yaml)
 - **Example Configs:** [values-dev.yaml](./values-dev.yaml), [values-production.yaml](./values-production.yaml), [values-airgapped.yaml](./values-airgapped.yaml)
 
diff --git a/quickstart-airgap.sh b/quickstart-airgap.sh
index 0f6097f..e52aade 100755
--- a/quickstart-airgap.sh
+++ b/quickstart-airgap.sh
@@ -30,7 +30,7 @@ fi
 
 echo "Step 1: Building Angular frontend locally..."
 echo "==========================================="
-./build-for-airgap.sh
+./scripts/build-for-airgap.sh
 
 echo ""
 echo "Step 2: Starting Docker containers..."
diff --git a/build-for-airgap.sh b/scripts/build-for-airgap.sh
similarity index 100%
rename from build-for-airgap.sh
rename to scripts/build-for-airgap.sh
diff --git a/check-ready.sh b/scripts/check-ready.sh
similarity index 97%
rename from check-ready.sh
rename to scripts/check-ready.sh
index 6f888b1..21ad278 100755
--- a/check-ready.sh
+++ b/scripts/check-ready.sh
@@ -18,7 +18,7 @@ else
     echo "  Expected: frontend/dist/frontend/browser"
     echo ""
     echo "  You need to build the Angular app first:"
-    echo "  Run: ./build-for-airgap.sh"
+    echo "  Run: ./scripts/build-for-airgap.sh"
     echo "  OR:  cd frontend && npm install && npm run build:prod"
     echo ""
     errors=$((errors + 1))