Setup before development
Everything to install and verify on the owner's machine before the first game task, with the verification command for each step and what Claude can do alone.
The machine was probed on 2026-10-03: Apple M3, 24 GB, macOS 26, Node 22, pnpm 10, Python 3.9 + Pillow, Git,
Chrome, Docker Desktop, Blender 4.2.3 LTS (~/Applications/Blender.app; it reports 4.5.9 LTS since, measured by M0-02 on 2026-10-08). Rust 1.99.0 and the .NET SDK 10.0.401 were installed on 2026-10-06 (owner approved; ~/.rustup, ~/.cargo, ~/.dotnet,
commands linked in ~/.local/bin, no shell profile edits). Unity is not installed yet; the pin is Unity 6.3 LTS.
Blender headless was verified by task T009: it built a mesh, exported a GLB and rendered with EEVEE in 18 s.
◆Can Claude do it all?
| Step | Claude alone? | Notes |
|---|---|---|
| Node/pnpm workspace, Next.js, Playwright | ✅ | Already done for this wiki |
| Rust toolchain | ✅ installed 2026-10-06 | rustup from sh.rustup.rs with --no-modify-path. Check: bash tools/setup/toolchain-smoke.sh rust |
| .NET SDK (LTS) | ✅ installed 2026-10-06 | dotnet-install.sh --channel LTS into ~/.dotnet, telemetry opted out. Check: bash tools/setup/toolchain-smoke.sh dotnet |
| Unity Hub + Unity 6.3 LTS + modules (Android, iOS, Web, Windows Mono) | ⚠️ install by agent or owner; sign-in by the owner | The owner allowed a command-line install (2026-10-06). The licence needs the owner's Unity ID; agents then drive the editor in batchmode. See Unity toolkit |
| Full Xcode (iOS builds) | ❌ owner | Xcode 26.6 seen on this Mac (2026-10-11); iOS is paused (ADR-032); device builds need an Apple ID |
| Windows PC: Rust + Visual Studio Build Tools (zoen-sim DLL) | ❌ owner | On the owner's Windows PC (ADR-032, 2026-10-11); agents can't reach it and never download the Windows SDK/CRT here; steps in WIN-01 |
| Blender scripts (rig, retarget, export, render) | ✅ | Headless via CLI; Blender MCP is optional |
| PostgreSQL in Docker | ✅ | Local only, free |
git init / commits | ⚠️ owner asks | Agents commit only when asked |
| Mixamo, Apple/Google developer accounts | ❌ owner | Agents never create accounts or enter passwords |
| Image generation (Codex/ChatGPT) | ⚠️ owner's tool | Use art requests |
| Paid 3D generation, hosting | ❌ until approved | PHP 5,000 cap for all new expenses |
◆Blender pipeline notes
- Alias:
alias blender=~/Applications/Blender.app/Contents/MacOS/Blender - Headless:
blender -b -P script.py -- <args>. Scripts live intools/blender/, are idempotent, and write a JSON report. - Export glTF 2.0 (
.glb): +Y up, metres, apply transforms,export_animations=True, Draco off for skinned meshes (compress later withgltf-transform). - Rigify ships with Blender. The canonical humanoid bone names are listed in Animation.
- Blender MCP (live editor control) is optional. Run the toolchain gatekeeper review before installing it.
◆Verify everything (one go)
node -v && pnpm -v && python3 -c "import PIL; print(PIL.__version__)"
~/Applications/Blender.app/Contents/MacOS/Blender --version | head -1
node tools/task-log.mjs test SETUP "blender smoke" -- ~/Applications/Blender.app/Contents/MacOS/Blender -b -P tools/blender/smoke.py -- logs/evidence/setup
pnpm data:test && pnpm wiki:build
node tools/task-log.mjs test SETUP "rust smoke" -- bash tools/setup/toolchain-smoke.sh rust
node tools/task-log.mjs test SETUP "dotnet smoke" -- bash tools/setup/toolchain-smoke.sh dotnet
Source: zoen/docs/process/SETUP.md · 551 words · edit the Markdown, not this page.