diff --git a/docs/studio-image-builder-test-script.md b/docs/studio-image-builder-test-script.md
new file mode 100644
index 0000000..6706fb6
--- /dev/null
+++ b/docs/studio-image-builder-test-script.md
@@ -0,0 +1,99 @@
+# Claw3D Studio Local Test Script
+
+This script verifies the current Claw3D Studio builders.
+
+Important.
+- The world builder and image-guided asset builder work locally.
+- No gateway connection is required for any steps in this document.
+- If the app shows any gateway-related controls in the header, they can be ignored for Studio testing.
+
+## Preconditions
+
+1. Install dependencies.
+2. Start Claw3D locally.
+3. Open the app in a browser.
+4. Navigate to `/studio`.
+
+Commands.
+- `npm install`
+- `npm run dev`
+
+## Test A: Text world builder
+
+Goal.
+- Confirm prompt-only world generation works without a gateway.
+
+Steps.
+1. Open `/studio`.
+2. Do not upload an image.
+3. Enter a project name.
+4. Enter a generation brief describing a world or asset set.
+5. Choose style, scale, focus, and optionally seed.
+6. Click `Generate scene`.
+
+Expected.
+- A new project appears in the project library.
+- The 3D preview renders.
+- Scene notes appear.
+- The project card shows `Export GLB`, `Export manifest`, and `Apply to office`.
+
+Extra checks.
+- Click `Export GLB` and confirm a `.glb` download starts.
+- Click `Export manifest` and confirm a `.json` download starts.
+- Click `Apply to office` and confirm a success status message appears.
+
+## Test B: Image-guided avatar builder
+
+Goal.
+- Confirm image upload and image-guided avatar proxy generation works locally.
+
+Steps.
+1. Open `/studio`.
+2. Click `Upload image`.
+3. Select a PNG, JPEG, or WEBP reference image.
+4. Wait for the upload to finish.
+5. Confirm the reference image preview appears.
+6. Confirm palette chips are extracted and displayed.
+7. Keep or update the project name and prompt.
+8. Click `Generate from image`.
+
+Expected.
+- A new project appears in the project library.
+- The project shows the `image avatar` mode tag.
+- The 3D preview renders an avatar-like proxy.
+- The preview shows the reference image overlay.
+- The project card shows a thumbnail of the uploaded source image.
+
+Extra checks.
+- Click `Export GLB` and confirm a `.glb` download starts.
+- Click `Export manifest` and confirm a `.json` download starts.
+- Confirm the status line reports successful generation and export.
+
+## Test C: Local-only behavior
+
+Goal.
+- Confirm Studio generation does not depend on any gateway.
+
+Steps.
+1. Keep the app on `/studio`.
+2. Do not connect any gateway.
+3. Run both Test A and Test B.
+
+Expected.
+- Text world generation still works.
+- Image-guided avatar generation still works.
+- GLB export still works.
+- No gateway connection is required at any point.
+
+## Automated checks
+
+Run these after code changes.
+- `npm run typecheck`
+- `npm run build`
+- `npm run test -- --run tests/unit/studioWorldRoute.test.ts`
+- `npx eslint src/app/api/studio-world/route.ts src/features/studio-world/**/*.tsx src/features/studio-world/**/*.ts src/lib/studio-world/**/*.ts tests/unit/studioWorldRoute.test.ts`
+
+## Current scope note
+
+The image builder currently creates a stylized 3D proxy guided by the uploaded image.
+It does not yet perform full neural image-to-mesh reconstruction.