@iwsdk/create 0.5.3 → 1.0.0-rc.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (106) hide show
  1. package/dist/cli.js +7223 -215
  2. package/dist/guidance/agents/.agents/skills/iwsdk-build-model/SKILL.md +311 -0
  3. package/dist/guidance/agents/.agents/skills/iwsdk-build-model/agents/openai.yaml +4 -0
  4. package/dist/guidance/agents/.agents/skills/iwsdk-build-model/assets/hardsurface.ts.template +599 -0
  5. package/dist/guidance/agents/.agents/skills/iwsdk-compose-scene/SKILL.md +262 -0
  6. package/dist/guidance/agents/.agents/skills/iwsdk-compose-scene/agents/openai.yaml +4 -0
  7. package/dist/guidance/agents/.agents/skills/iwsdk-compose-scene/references/extended-workflow.md +166 -0
  8. package/dist/guidance/agents/.agents/skills/iwsdk-compose-scene/references/scene-composition.md +80 -0
  9. package/dist/guidance/{claude/.claude/skills/iwsdk-scene-composer → agents/.agents/skills/iwsdk-compose-scene}/references/scene-format.md +3 -3
  10. package/dist/guidance/agents/.agents/skills/iwsdk-compose-scene/references/scene-review.md +66 -0
  11. package/dist/guidance/agents/.agents/skills/{iwsdk-scene-composer → iwsdk-compose-scene}/references/text-intake.md +3 -5
  12. package/dist/guidance/agents/.agents/skills/iwsdk-debug/SKILL.md +69 -91
  13. package/dist/guidance/agents/.agents/skills/iwsdk-depth-occlusion/SKILL.md +81 -129
  14. package/dist/guidance/agents/.agents/skills/iwsdk-dev/SKILL.md +45 -0
  15. package/dist/guidance/{claude/.claude/skills/iwsdk-planner → agents/.agents/skills/iwsdk-dev}/references/api-reference.md +53 -45
  16. package/dist/guidance/agents/.agents/skills/iwsdk-dev/references/iterate.md +239 -0
  17. package/dist/guidance/agents/.agents/skills/iwsdk-dev/references/planner.md +303 -0
  18. package/dist/guidance/agents/.agents/skills/iwsdk-grab/SKILL.md +37 -114
  19. package/dist/guidance/agents/.agents/skills/iwsdk-hosting/SKILL.md +177 -0
  20. package/dist/guidance/agents/.agents/skills/iwsdk-hosting/references/existing-hosts.md +181 -0
  21. package/dist/guidance/agents/.agents/skills/iwsdk-hosting/references/vercel.md +114 -0
  22. package/dist/guidance/agents/.agents/skills/iwsdk-native-xr-test/SKILL.md +246 -0
  23. package/dist/guidance/agents/.agents/skills/iwsdk-physics/SKILL.md +92 -78
  24. package/dist/guidance/agents/.agents/skills/iwsdk-physics/references/tuning-and-config.md +15 -1
  25. package/dist/guidance/agents/.agents/skills/iwsdk-pwa-packaging/SKILL.md +218 -0
  26. package/dist/guidance/agents/.agents/skills/iwsdk-pwa-packaging/references/app-modes.md +104 -0
  27. package/dist/guidance/agents/.agents/skills/iwsdk-pwa-packaging/references/bubblewrap.md +219 -0
  28. package/dist/guidance/agents/.agents/skills/iwsdk-pwa-packaging/references/manifest-and-icons.md +149 -0
  29. package/dist/guidance/agents/.agents/skills/iwsdk-pwa-packaging/references/store-upload.md +104 -0
  30. package/dist/guidance/agents/.agents/skills/iwsdk-pwa-packaging/references/troubleshooting.md +178 -0
  31. package/dist/guidance/agents/.agents/skills/iwsdk-ray/SKILL.md +45 -136
  32. package/dist/guidance/agents/.agents/skills/iwsdk-ui/SKILL.md +251 -157
  33. package/dist/guidance/claude/.claude/agents/iwsdk-project-code-reviewer.md +9 -6
  34. package/dist/guidance/claude/.claude/rules/scene-json.md +6 -4
  35. package/dist/guidance/claude/.claude/settings.json +6 -2
  36. package/dist/guidance/claude/.claude/skills/iwsdk-build-model/SKILL.md +311 -0
  37. package/dist/guidance/claude/.claude/skills/iwsdk-build-model/agents/openai.yaml +4 -0
  38. package/dist/guidance/claude/.claude/skills/iwsdk-build-model/assets/hardsurface.ts.template +599 -0
  39. package/dist/guidance/claude/.claude/skills/iwsdk-compose-scene/SKILL.md +262 -0
  40. package/dist/guidance/claude/.claude/skills/iwsdk-compose-scene/agents/openai.yaml +4 -0
  41. package/dist/guidance/claude/.claude/skills/iwsdk-compose-scene/references/extended-workflow.md +166 -0
  42. package/dist/guidance/claude/.claude/skills/iwsdk-compose-scene/references/scene-composition.md +80 -0
  43. package/dist/guidance/{agents/.agents/skills/iwsdk-scene-composer → claude/.claude/skills/iwsdk-compose-scene}/references/scene-format.md +3 -3
  44. package/dist/guidance/claude/.claude/skills/iwsdk-compose-scene/references/scene-review.md +66 -0
  45. package/dist/guidance/claude/.claude/skills/{iwsdk-scene-composer → iwsdk-compose-scene}/references/text-intake.md +3 -5
  46. package/dist/guidance/claude/.claude/skills/iwsdk-debug/SKILL.md +69 -91
  47. package/dist/guidance/claude/.claude/skills/iwsdk-depth-occlusion/SKILL.md +81 -129
  48. package/dist/guidance/claude/.claude/skills/iwsdk-dev/SKILL.md +45 -0
  49. package/dist/guidance/{agents/.agents/skills/iwsdk-planner → claude/.claude/skills/iwsdk-dev}/references/api-reference.md +53 -45
  50. package/dist/guidance/claude/.claude/skills/iwsdk-dev/references/iterate.md +239 -0
  51. package/dist/guidance/claude/.claude/skills/iwsdk-dev/references/planner.md +303 -0
  52. package/dist/guidance/claude/.claude/skills/iwsdk-grab/SKILL.md +37 -114
  53. package/dist/guidance/claude/.claude/skills/iwsdk-hosting/SKILL.md +177 -0
  54. package/dist/guidance/claude/.claude/skills/iwsdk-hosting/references/existing-hosts.md +181 -0
  55. package/dist/guidance/claude/.claude/skills/iwsdk-hosting/references/vercel.md +114 -0
  56. package/dist/guidance/claude/.claude/skills/iwsdk-native-xr-test/SKILL.md +246 -0
  57. package/dist/guidance/claude/.claude/skills/iwsdk-physics/SKILL.md +92 -78
  58. package/dist/guidance/claude/.claude/skills/iwsdk-physics/references/tuning-and-config.md +15 -1
  59. package/dist/guidance/claude/.claude/skills/iwsdk-pwa-packaging/SKILL.md +218 -0
  60. package/dist/guidance/claude/.claude/skills/iwsdk-pwa-packaging/references/app-modes.md +104 -0
  61. package/dist/guidance/claude/.claude/skills/iwsdk-pwa-packaging/references/bubblewrap.md +219 -0
  62. package/dist/guidance/claude/.claude/skills/iwsdk-pwa-packaging/references/manifest-and-icons.md +149 -0
  63. package/dist/guidance/claude/.claude/skills/iwsdk-pwa-packaging/references/store-upload.md +104 -0
  64. package/dist/guidance/claude/.claude/skills/iwsdk-pwa-packaging/references/troubleshooting.md +178 -0
  65. package/dist/guidance/claude/.claude/skills/iwsdk-ray/SKILL.md +45 -136
  66. package/dist/guidance/claude/.claude/skills/iwsdk-ui/SKILL.md +251 -157
  67. package/dist/guidance/claude/CLAUDE.md +2 -141
  68. package/dist/guidance/codex/.codex/config.toml +1 -1
  69. package/dist/guidance/common/AGENTS.md +96 -37
  70. package/dist/guidance/copilot/.github/instructions/scene-json.instructions.md +6 -4
  71. package/dist/guidance/cursor/.cursor/rules/scene-json.mdc +6 -4
  72. package/dist/guidance/scoped-agents/public/scenes/AGENTS.md +6 -4
  73. package/dist/template/common/README.md +13 -0
  74. package/dist/template/common/public/ui/welcome.uikitml +0 -19
  75. package/dist/template/common/src/robot.ts +5 -0
  76. package/dist/template/common/vite.config.ts +18 -0
  77. package/dist/template/common-js/README.md +13 -0
  78. package/dist/template/common-js/public/ui/welcome.uikitml +0 -19
  79. package/dist/template/common-js/src/robot.js +5 -0
  80. package/dist/template/common-js/vite.config.js +18 -0
  81. package/package.json +8 -7
  82. package/scripts/verify-release-ready.mjs +25 -0
  83. package/dist/guidance/agents/.agents/skills/iwsdk-planner/SKILL.md +0 -364
  84. package/dist/guidance/agents/.agents/skills/iwsdk-planner/references/build-milestones.md +0 -243
  85. package/dist/guidance/agents/.agents/skills/iwsdk-planner/references/design-deck.md +0 -101
  86. package/dist/guidance/agents/.agents/skills/iwsdk-planner/references/grounding.md +0 -176
  87. package/dist/guidance/agents/.agents/skills/iwsdk-planner/references/ideation.md +0 -156
  88. package/dist/guidance/agents/.agents/skills/iwsdk-planner/references/verification.md +0 -199
  89. package/dist/guidance/agents/.agents/skills/iwsdk-scene-composer/SKILL.md +0 -257
  90. package/dist/guidance/agents/.agents/skills/iwsdk-scene-composer/agents/openai.yaml +0 -4
  91. package/dist/guidance/agents/.agents/skills/iwsdk-scene-composer/references/asset-authoring.md +0 -295
  92. package/dist/guidance/agents/.agents/skills/iwsdk-scene-composer/references/composition-patterns.md +0 -243
  93. package/dist/guidance/agents/.agents/skills/iwsdk-scene-composer/references/review-and-stop.md +0 -99
  94. package/dist/guidance/claude/.claude/skills/iwsdk-planner/SKILL.md +0 -364
  95. package/dist/guidance/claude/.claude/skills/iwsdk-planner/references/build-milestones.md +0 -243
  96. package/dist/guidance/claude/.claude/skills/iwsdk-planner/references/design-deck.md +0 -101
  97. package/dist/guidance/claude/.claude/skills/iwsdk-planner/references/grounding.md +0 -176
  98. package/dist/guidance/claude/.claude/skills/iwsdk-planner/references/ideation.md +0 -156
  99. package/dist/guidance/claude/.claude/skills/iwsdk-planner/references/verification.md +0 -199
  100. package/dist/guidance/claude/.claude/skills/iwsdk-scene-composer/SKILL.md +0 -257
  101. package/dist/guidance/claude/.claude/skills/iwsdk-scene-composer/agents/openai.yaml +0 -4
  102. package/dist/guidance/claude/.claude/skills/iwsdk-scene-composer/references/asset-authoring.md +0 -295
  103. package/dist/guidance/claude/.claude/skills/iwsdk-scene-composer/references/composition-patterns.md +0 -243
  104. package/dist/guidance/claude/.claude/skills/iwsdk-scene-composer/references/review-and-stop.md +0 -99
  105. /package/dist/guidance/agents/.agents/skills/{iwsdk-scene-composer → iwsdk-compose-scene}/references/image-intake.md +0 -0
  106. /package/dist/guidance/claude/.claude/skills/{iwsdk-scene-composer → iwsdk-compose-scene}/references/image-intake.md +0 -0
@@ -1,243 +0,0 @@
1
- # Composition Patterns
2
-
3
- ## Contents
4
-
5
- 1. Representation Ladder
6
- 2. Object Reconstruction
7
- 3. Environment Composition
8
- 4. Repetition
9
- 5. Camera And Lighting
10
- 6. Cost Control
11
-
12
- ## Representation Ladder
13
-
14
- Match silhouette and proportions before surface detail. All visible scene content is
15
- an `asset` reference, but the registered asset may be a glTF or a procedural
16
- `Object3D`. Choose the lowest-complexity asset implementation that preserves every
17
- required feature:
18
-
19
- | Form | Asset implementation |
20
- | --------------------------------------- | -------------------------- |
21
- | Rectilinear mass, panel, slab | Box geometry |
22
- | Soft-edged block, cushion, casing | Rounded-box geometry |
23
- | Rounded mass, joint, crown | Scaled sphere geometry |
24
- | Pole or simple column | Cylinder or cone geometry |
25
- | Rotational vessel, turned seat, shade | Lathe geometry |
26
- | Wheel, ring, circular handle | Torus geometry |
27
- | Limb, padded rail, soft elongated body | Capsule geometry |
28
- | Flat profile with meaningful outline | Shape/extrude geometry |
29
- | Branch, pipe, cable, bicycle frame | Tube along explicit points |
30
- | Reusable part hierarchy | Procedural asset or prefab |
31
- | Repeated compatible detail | Deterministic pattern |
32
- | Identity-critical asset already present | Registered glTF asset |
33
-
34
- Create geometry and materials in an asset module and register its parentless root in
35
- the manifest. Keep composition and repetition in scene JSON. Do not force an organic
36
- continuous form into a single box, and do not import an opaque glTF solely to avoid a
37
- small deterministic procedural asset.
38
-
39
- ## Object Reconstruction
40
-
41
- Build one semantic hierarchy in this order:
42
-
43
- 1. root at a stable support/pivot point;
44
- 2. primary masses and bounding proportions;
45
- 3. structural connectors and negative spaces;
46
- 4. silhouette-defining secondary forms;
47
- 5. repeated identity details;
48
- 6. shared material families and small accents in asset code.
49
-
50
- Keep parts separate when their boundary, material, or transform matters. Merge visual
51
- noise into a larger form when it cannot affect a required view.
52
-
53
- Every layout-critical semantic group must contain actual coarse renderables for its
54
- primary masses. Keep those assets, instances, or patterns visible in the `layout`
55
- lens. An empty group is a useful transform root and feature binding, but it
56
- has no bounds, pixels, support contact, or silhouette and therefore cannot be the
57
- group's layout proxy.
58
-
59
- ### Stool Or Small Furniture
60
-
61
- - seat: lathe, cylinder, extruded outline, or shallow rounded box;
62
- - legs: tapered cylinders or capsules, parented under the root;
63
- - braces: tubes/cylinders between measured endpoints;
64
- - upholstery: scaled capsule/sphere or layered rounded masses;
65
- - seams/buttons: sparse repeated small geometry only when identity-critical.
66
-
67
- Place the root on the floor. Check seat height and leg spread in front and side views.
68
- Preserve negative space between legs.
69
-
70
- ### Armchair And Reading Furniture
71
-
72
- Compose seat cushion, back cushion, arms, frame, and legs as independent parts. Use
73
- rounded boxes, scaled capsules/spheres for soft cushions, and boxes/tubes for the
74
- frame. Overlap soft parts slightly to avoid visible gaps. Match the outer silhouette
75
- and seat/back angle before seams or buttons.
76
-
77
- ### Mechanical Prop Or Generator
78
-
79
- Start with chassis and major cylindrical/box volumes. Add one hierarchy per visible
80
- system: frame, tank, vents, control panel, handles, cables, fasteners. Use exact
81
- patterns for manufactured vents/bolts. Use tubes for cables and pipes. Keep painted
82
- metal dielectric; reserve high metalness for exposed metal.
83
-
84
- ### Bicycle Or Thin Frame
85
-
86
- Use two wheel cylinders/tori in a procedural asset, or use a registered glTF when
87
- silhouette fidelity requires it. Build a procedural frame from tubes between stable
88
- joint points. Use separate
89
- fork, handlebar, crank, saddle, and pedal groups. Verify wheel coplanarity, contact
90
- with ground, and frame negative spaces from a side view, then check real volume from a
91
- quarter view.
92
-
93
- ### Animal Or Organic Character Blockout
94
-
95
- Use a root at ground contact, capsules/ellipsoids for torso and limbs, spheres for
96
- joints/head, cones or extrudes for ears/tail accents, and tubes for curved tails.
97
- Preserve pose, body proportions, leg contacts, head direction, and silhouette before
98
- facial detail. A procedural animal assembled from simple geometry is a stylized
99
- blockout; state the ceiling when fur, anatomy, or likeness is required.
100
-
101
- ### Tree, Stump, Or Plant
102
-
103
- Use a tapered cylinder/extrude for the trunk, tubes for branches/roots/stems, scaled
104
- spheres/cones or extruded leaves for foliage. Model major silhouette branches
105
- explicitly. Use deterministic seeded patterns for compatible smaller branches/leaves,
106
- with bounded count and variation. Avoid a uniform sphere when the reference depends on
107
- an irregular crown or gnarled outline.
108
-
109
- ### Tent Or Fabric Shelter
110
-
111
- Use an extruded triangular/arched profile or thin planes for fabric panels, tubes for
112
- poles, and cylinders/tubes for guy lines. Keep planes double-sided only where needed.
113
- Offset layered flaps to avoid z-fighting. Verify support points and interior opening
114
- from front and quarter views.
115
-
116
- ### Lantern Or Transparent Vessel
117
-
118
- Build the metal frame first, then a low-opacity double-sided glazing proxy when
119
- supported. Use cylinders/extrudes for body and cap, tubes for cage/handle, and a small
120
- emissive interior source plus actual light when required. Scalar opacity does not
121
- provide refraction; record that limitation.
122
-
123
- ### Arch Or Masonry Opening
124
-
125
- Prefer one extrude with an explicit opening hole for a clean arch silhouette. Otherwise
126
- compose two pillars and a ring of wedge-like repeated blocks, keeping the opening
127
- unobstructed. Model the void, not a painted arch on a solid wall. Use irregular but
128
- bounded variation only after the main curve and support contact are correct.
129
-
130
- ## Environment Composition
131
-
132
- Use a shallow semantic hierarchy:
133
-
134
- ```text
135
- scene
136
- ground-and-paths
137
- architecture
138
- focal-cluster
139
- furniture-and-props
140
- vegetation
141
- lights
142
- ```
143
-
144
- ### Architecture
145
-
146
- Create one group per building. Start with body, roof, foundation, primary openings,
147
- and large facade bands. Add window/balcony prefabs only after one module is correct.
148
- Use a consistent facade offset of roughly `0.01..0.04` meters to prevent z-fighting.
149
- Infer floor height from doors or people when visible; otherwise record a conventional
150
- scale assumption.
151
-
152
- ### Roads, Paths, And Ground
153
-
154
- Use thin boxes for surfaces needing reliable support bounds. Use polygon/extrude for
155
- irregular patios or paths. Put lane/edge markings slightly above the surface. Avoid
156
- overlapping coplanar planes. Validate layout from top and vertical contact from front.
157
-
158
- For a studio floor or seamless background support, use one surface large enough to
159
- cover the scene footprint and every required, alternate, and diagnostic camera
160
- frustum. Match its base value to the environment background when continuity is
161
- intended, while preserving enough lighting response to show contact shadows. Inspect
162
- every exact saved view for a horizon, diagonal plane edge, corner, or value seam; a
163
- hero-only edge check is insufficient. Mark oversized infrastructure nodes
164
- `framingRole: "support"` and fit the camera to `framingBounds`; use raw `worldBounds`
165
- and exact-view captures to verify support coverage, so the oversized support neither
166
- clips nor inflates subject framing.
167
-
168
- ### Furniture Clusters
169
-
170
- Preserve reachability and conversational orientation: chairs face the focal center,
171
- tables sit at usable height, lamps stand beside rather than inside furniture, and
172
- objects share the same support surface. Bind the cluster and each identity-critical
173
- object to feature criteria.
174
-
175
- ### Vegetation Borders
176
-
177
- Model prominent plants explicitly. Use prefabs and deterministic scatter/along-path
178
- patterns for background beds. Separate trunk/stem and crown/leaf material families.
179
- Vary scale/yaw within a narrow range and keep the distribution reproducible.
180
-
181
- ### Vehicles And People
182
-
183
- Use a group origin at ground contact. For vehicles, compose body/cabin/wheels and
184
- orient the group along the path. For distant people, register simplified procedural
185
- assets with torso/head/limb geometry and preserve height/stance. Avoid identical
186
- prominent poses.
187
-
188
- ## Repetition
189
-
190
- Use exact grid/linear/radial/along-path patterns for manufactured structures and
191
- seeded scatter for organic distribution. Name the algorithm/version and seed.
192
-
193
- Build and validate one prefab before instancing. Keep local IDs semantic. Use explicit
194
- instances when individual components or unique transforms are required. Material
195
- variants are separate manifest assets, not scene overrides.
196
- Use a pattern only when all instances can share compatible render content.
197
-
198
- Do not add hundreds of explicit nodes when a bounded pattern expresses the same
199
- authoring intent. Do not use a pattern to hide meaningful per-instance differences.
200
-
201
- ## Camera And Lighting
202
-
203
- Treat the player spawn as a required application camera, not an incidental origin.
204
- Unless `player.transform` says otherwise, the player's feet are at `[0, 0, 0]` and
205
- their first-person view is approximately `[0, 1.6, 0]`. Keep that standing volume
206
- clear and inspect a saved spawn view before accepting the composition.
207
-
208
- Tune a reference camera in this order:
209
-
210
- 1. target at the composition/object center;
211
- 2. projection type;
212
- 3. azimuth for visible side proportions;
213
- 4. elevation for visible top area;
214
- 5. distance/FOV or orthographic height for framing;
215
- 6. geometry/placement for remaining overlap differences.
216
-
217
- Never distort support or obvious volume solely to match one view. Validate a
218
- non-planar form from at least one alternate angle.
219
-
220
- Use lights to reveal authored form rather than paint lighting into base color. For a
221
- studio or product scene, prefer Room IBL plus one or two rectangular area lights and
222
- a low-intensity shadow-casting directional light when contact shadows matter. For a
223
- broad environment, ambient/hemisphere fill plus a directional key remains useful.
224
- Author lights as ECS components. Directional, spot, and rectangular area lights emit
225
- along their node's local `-Z` axis, so aim them with the node rotation. Keep review
226
- geometry lighting neutral and separate from final-look lighting.
227
-
228
- ## Cost Control
229
-
230
- - Use low segment counts for small/distant curved parts and increase only when a
231
- required silhouette visibly benefits.
232
- - Instance compatible repetition. Record the expanded count and draw-call lowering.
233
- - Disable shadow casting on tiny repeated trim, leaves, fasteners, and markings unless
234
- their shadows carry a required feature.
235
- - Begin with `castShadow: false` on assets, then opt in focal grounded
236
- masses deliberately. Treat more than one shadow caster per four visible meshes as
237
- a review trigger, not as physical-device performance proof; retain a feature-based
238
- justification for any exception.
239
- - Avoid hidden back-side detail that cannot affect any required or application view.
240
- - Reuse material instances inside asset modules instead of gratuitous one-off values.
241
- - Keep transparent surfaces sparse and inspect sorting from required views.
242
- - Record raw calls, triangles, programs, textures, shadow casters, and frame samples;
243
- do not substitute node count for measured renderer cost.
@@ -1,99 +0,0 @@
1
- # Review And Stop
2
-
3
- Use this reference after each authored module and again after root composition.
4
- Review logic and evidence live in ordinary task files. The editor supplies raw,
5
- authoritative observations; it does not own the review workflow.
6
-
7
- ## Inputs
8
-
9
- Retain:
10
-
11
- - root and module paths;
12
- - source, composed, runtime, capability, and screenshot hashes;
13
- - exact camera state and resolution;
14
- - renderer environment and render statistics;
15
- - reference image regions and assumptions;
16
- - required features with owning IDs and acceptance criteria.
17
-
18
- Call `scene_render_file` for off-document validation and rendering through the
19
- command-ready managed editor browser. A result is usable only when `valid` is true
20
- and an authoritative PNG is returned. A custom renderer is diagnostic evidence, not
21
- a substitute. For the open root use `scene_get_state`, `scene_set_camera`, and
22
- `scene_screenshot`.
23
-
24
- ## Object Review
25
-
26
- Review identity-critical objects before judging the full scene. Capture each required
27
- view under neutral form-reading conditions and representative final lighting.
28
-
29
- For every object inspect:
30
-
31
- 1. silhouette;
32
- 2. major proportions;
33
- 3. required parts;
34
- 4. negative spaces;
35
- 5. support contacts and placement;
36
- 6. material response;
37
- 7. appearance in context.
38
-
39
- Use `scene_set_preview_visibility` for temporary solo-with-context or ghosted views.
40
- It must not change scene hashes. Store observations and screenshot references in the
41
- task evidence, not in the scene editor.
42
-
43
- ## Composition Review
44
-
45
- Review in this order:
46
-
47
- 1. **Layout**: hierarchy, scale, support contacts, top/front/side arrangement, floor
48
- and backdrop coverage.
49
- 2. **Geometry**: alternate-angle volume, silhouette, proportions, occlusion, and
50
- identity-critical details.
51
- 3. **Final**: materials, color, light, environment, shadows, and hero framing.
52
- 4. **Spawn**: inspect the exact player-origin view at standing eye height and confirm
53
- that no authored geometry intersects the player's standing volume.
54
-
55
- For image-driven work, align source and render at the same aspect ratio. Use explicit
56
- source regions and measurable projected bounds. `scene_measure_image_regions` is
57
- appropriate only when source/render alignment and the requested color, luma,
58
- highlight, or shadow statistic are meaningful.
59
-
60
- Do not present an estimated decimal as a measured score. Record categorical outcomes
61
- and actual measurements separately.
62
-
63
- ## Defects
64
-
65
- Classify the largest remaining defect as one of:
66
-
67
- - `contract`: requirement or ownership is wrong or incomplete;
68
- - `resource`: asset/material cannot express the requirement;
69
- - `scene`: geometry, placement, hierarchy, or lighting is wrong;
70
- - `camera`: projection, pose, crop, or framing is wrong;
71
- - `runtime`: composed and live application results differ.
72
-
73
- Fix the owning module or root file directly. Rerender the changed module first and
74
- then the root. Preserve the previous evidence so regressions are visible.
75
-
76
- ## Performance Review
77
-
78
- Use render statistics returned by `scene_get_state`, `scene_screenshot`, or
79
- `scene_render_file`. Treat gratuitous draw calls, unique repeated geometry, large
80
- textures, and unnecessary shadow casters as defects. Desktop/browser frame samples
81
- are diagnostics, not calibrated headset performance.
82
-
83
- ## Stop Rules
84
-
85
- Default to at most two focused correction rounds after the first complete review.
86
- Stop earlier when:
87
-
88
- - the same defect repeats;
89
- - two changes oscillate;
90
- - applicable diagnostics plateau or regress;
91
- - required input or assets are missing;
92
- - the representation ceiling cannot satisfy a required feature;
93
- - a user decision is required.
94
-
95
- Completion requires all scratch-module renders to pass, a flattened import-free root,
96
- a clean conflict-free editor state, nonblank required views (including player spawn),
97
- passing required features, and a live application runtime bound to the expected
98
- root/runtime hash. There is no editor publish tool; record the final evidence and
99
- verify the application build normally.