diff --git a/.github/workflows/build-test.yml b/.github/workflows/build-test.yml
index ab492b1..21f8cb1 100644
--- a/.github/workflows/build-test.yml
+++ b/.github/workflows/build-test.yml
@@ -60,6 +60,8 @@ jobs:
           REGISTRY_USER: ${{ secrets.DOCKER_REGISTRY_USER }}
           REGISTRY_PASSWORD: ${{ secrets.DOCKER_REGISTRY_PASSWORD }}
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          extra_build_args: NPM_REGISTRY_URL=${{ inputs.npm_registry }}
+          npm_registry_token: ${{ secrets.NPM_REGISTRY_TOKEN }}
 
   jest:
     runs-on: ubuntu-latest
diff --git a/README.md b/README.md
index 5464276..c620411 100644
--- a/README.md
+++ b/README.md
@@ -138,7 +138,7 @@ Complete CI workflow for Node.js projects.
 
 **Jobs:**
 1. **metadata** - Generate image.json
-2. **build** - Build Docker image
+2. **build** - Build Docker image (passes `NPM_REGISTRY_URL` as a Docker build-arg via `extra_build_args` so `@agent-ix/*` scoped packages resolve during `pnpm install`)
 3. **jest** - Run tests
 4. **eslint** - Run linting
 5. **prettier** - Check formatting