fix(templates): enforce consumed 3D config

[wh000wh000]

结论

threed_basic v1.2 removes dead 3D configuration and makes the builder contract require every emitted config leaf to have a runtime consumer. A real POST-produced game verifies the versioned template path end to end.

Production evidence

Sample	Purpose	Result
three-js-prism-causeway-3d-v1-2-slug-pri (3a179ad6fa430dc3)	First v1.2 production run	Build, WebGL/non-black smoke, ESC, 6/6 keyboard autopilot, and v2-accept passed; exposed protocol split-brain
three-js-crystal-switchback-3d-v1-2-5-sc (8a7e3739cc6d0e80)	Run after protocol root-cause fix	Build, smoke, ESC, 5/5 keyboard completion, and v2-accept passed; CollisionResolver.ts and InputController.ts are byte-identical to this branch's templates

Root cause and change

The production classifier/GDD used a versioned worktree, while scaffold and Phase 5 still referenced the canonical OpenGame checkout. That allowed a generated game to consume stale templates and rewrite CollisionResolver.

This PR keeps the frozen-layer change small:

• removes unconsumed screenSize leaves from both 3D config fragments;
• documents the existing config-consumer invariant in the three threed_basic builder manuals;
• specializes generate_gdd guidance for 3D while preserving the prior Phaser reminder verbatim;
• adds one focused test for 3D guidance and the unchanged Phaser path.

The protocol-side root-cause fix is in non-Git /Users/admin/Desktop/opengame-kimi/agent/opengame.md: scaffold paths now honor GAME_TEMPLATES_DIR/GAME_DOCS_DIR, Phase 3 reads the workspace asset protocol, and Phase 4 requires zero dead 3D config. It cannot be represented honestly in this repository's Git diff.

Verification

Gate	Result
npm run build --workspace=packages/core	PASS
npm test --workspace=packages/core	PASS: 151 files, 3166 passed, 2 skipped
Targeted generate-gdd tests	PASS: 3/3
make check in opengame-kimi	PASS: 6/6 protocol tools consistent
opengame-kimi MCP selftest	PASS
core3d build + WebGL/non-black/console-zero smoke	PASS
merged core3d + threed_basic build/self-check	PASS
config consumer audit	PASS: 0 dead keys in core3d and threed_basic
Crystal production game	PASS: build, smoke, ESC resume, 5/5 completion, v2-accept
Phaser neon-flotilla regression	PASS with explicit Enter: WebGL/non-black, console zero, ESC pause/resume

Frozen-layer delta

Path	Change
agent-test/templates/core3d/src/gameConfig.json	Remove dead screenSize object
agent-test/templates/modules/threed_basic/src/gameConfig.json	Remove dead screenSize overrides
agent-test/docs/modules/threed_basic/{design_rules,template_api,threed_basic}.md	Require config leaves to map to runtime consumers
packages/core/src/tools/generate-gdd.ts	3D-specific merge reminder; Phaser behavior retained
packages/core/src/tools/generate-gdd.test.ts	Minimal regression check

Risk and rollback

Risk is limited to builder guidance and deletion of proven-unused 3D config. Phaser output is covered by an explicit regression test and real smoke. Roll back the three Conventional Commits independently in reverse order if needed.

Upstream dependency: this iteration builds on the 3D v1/v1.1 series tracked in upstream PRs #47 and #48.

[wh000wh000]

Superseded by #57, which rebases the complete threed_basic v1 milestone onto current origin/main and excludes unrelated fork-only changes.