diff --git a/.github/workflows/deploy-docs.yml b/.github/workflows/deploy-docs.yml
index 888042e..321da5f 100644
--- a/.github/workflows/deploy-docs.yml
+++ b/.github/workflows/deploy-docs.yml
@@ -35,6 +35,9 @@ jobs:
         with:
           node-version: 22
 
+      - name: Enable Corepack
+        run: corepack enable
+
       - name: Setup Pages
         uses: actions/configure-pages@v5
 
diff --git a/docs/CLAUDE.md b/docs/CLAUDE.md
index c415400..7c1f087 100644
--- a/docs/CLAUDE.md
+++ b/docs/CLAUDE.md
@@ -150,6 +150,7 @@ The docs are a standalone package, independent of the root project. This allows:
 ### Setup
 
 ```bash
+corepack enable  # Enable Yarn 3 via Corepack (one-time setup)
 cd docs
 yarn install
 ```
diff --git a/docs/package.json b/docs/package.json
index c1d71de..dfe707b 100644
--- a/docs/package.json
+++ b/docs/package.json
@@ -14,5 +14,6 @@
   },
   "engines": {
     "node": ">=18"
-  }
+  },
+  "packageManager": "yarn@3.8.7"
 }