@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.
- package/dist/cli.js +7223 -215
- package/dist/guidance/agents/.agents/skills/iwsdk-build-model/SKILL.md +311 -0
- package/dist/guidance/agents/.agents/skills/iwsdk-build-model/agents/openai.yaml +4 -0
- package/dist/guidance/agents/.agents/skills/iwsdk-build-model/assets/hardsurface.ts.template +599 -0
- package/dist/guidance/agents/.agents/skills/iwsdk-compose-scene/SKILL.md +262 -0
- package/dist/guidance/agents/.agents/skills/iwsdk-compose-scene/agents/openai.yaml +4 -0
- package/dist/guidance/agents/.agents/skills/iwsdk-compose-scene/references/extended-workflow.md +166 -0
- package/dist/guidance/agents/.agents/skills/iwsdk-compose-scene/references/scene-composition.md +80 -0
- package/dist/guidance/{claude/.claude/skills/iwsdk-scene-composer → agents/.agents/skills/iwsdk-compose-scene}/references/scene-format.md +3 -3
- package/dist/guidance/agents/.agents/skills/iwsdk-compose-scene/references/scene-review.md +66 -0
- package/dist/guidance/agents/.agents/skills/{iwsdk-scene-composer → iwsdk-compose-scene}/references/text-intake.md +3 -5
- package/dist/guidance/agents/.agents/skills/iwsdk-debug/SKILL.md +69 -91
- package/dist/guidance/agents/.agents/skills/iwsdk-depth-occlusion/SKILL.md +81 -129
- package/dist/guidance/agents/.agents/skills/iwsdk-dev/SKILL.md +45 -0
- package/dist/guidance/{claude/.claude/skills/iwsdk-planner → agents/.agents/skills/iwsdk-dev}/references/api-reference.md +53 -45
- package/dist/guidance/agents/.agents/skills/iwsdk-dev/references/iterate.md +239 -0
- package/dist/guidance/agents/.agents/skills/iwsdk-dev/references/planner.md +303 -0
- package/dist/guidance/agents/.agents/skills/iwsdk-grab/SKILL.md +37 -114
- package/dist/guidance/agents/.agents/skills/iwsdk-hosting/SKILL.md +177 -0
- package/dist/guidance/agents/.agents/skills/iwsdk-hosting/references/existing-hosts.md +181 -0
- package/dist/guidance/agents/.agents/skills/iwsdk-hosting/references/vercel.md +114 -0
- package/dist/guidance/agents/.agents/skills/iwsdk-native-xr-test/SKILL.md +246 -0
- package/dist/guidance/agents/.agents/skills/iwsdk-physics/SKILL.md +92 -78
- package/dist/guidance/agents/.agents/skills/iwsdk-physics/references/tuning-and-config.md +15 -1
- package/dist/guidance/agents/.agents/skills/iwsdk-pwa-packaging/SKILL.md +218 -0
- package/dist/guidance/agents/.agents/skills/iwsdk-pwa-packaging/references/app-modes.md +104 -0
- package/dist/guidance/agents/.agents/skills/iwsdk-pwa-packaging/references/bubblewrap.md +219 -0
- package/dist/guidance/agents/.agents/skills/iwsdk-pwa-packaging/references/manifest-and-icons.md +149 -0
- package/dist/guidance/agents/.agents/skills/iwsdk-pwa-packaging/references/store-upload.md +104 -0
- package/dist/guidance/agents/.agents/skills/iwsdk-pwa-packaging/references/troubleshooting.md +178 -0
- package/dist/guidance/agents/.agents/skills/iwsdk-ray/SKILL.md +45 -136
- package/dist/guidance/agents/.agents/skills/iwsdk-ui/SKILL.md +251 -157
- package/dist/guidance/claude/.claude/agents/iwsdk-project-code-reviewer.md +9 -6
- package/dist/guidance/claude/.claude/rules/scene-json.md +6 -4
- package/dist/guidance/claude/.claude/settings.json +6 -2
- package/dist/guidance/claude/.claude/skills/iwsdk-build-model/SKILL.md +311 -0
- package/dist/guidance/claude/.claude/skills/iwsdk-build-model/agents/openai.yaml +4 -0
- package/dist/guidance/claude/.claude/skills/iwsdk-build-model/assets/hardsurface.ts.template +599 -0
- package/dist/guidance/claude/.claude/skills/iwsdk-compose-scene/SKILL.md +262 -0
- package/dist/guidance/claude/.claude/skills/iwsdk-compose-scene/agents/openai.yaml +4 -0
- package/dist/guidance/claude/.claude/skills/iwsdk-compose-scene/references/extended-workflow.md +166 -0
- package/dist/guidance/claude/.claude/skills/iwsdk-compose-scene/references/scene-composition.md +80 -0
- package/dist/guidance/{agents/.agents/skills/iwsdk-scene-composer → claude/.claude/skills/iwsdk-compose-scene}/references/scene-format.md +3 -3
- package/dist/guidance/claude/.claude/skills/iwsdk-compose-scene/references/scene-review.md +66 -0
- package/dist/guidance/claude/.claude/skills/{iwsdk-scene-composer → iwsdk-compose-scene}/references/text-intake.md +3 -5
- package/dist/guidance/claude/.claude/skills/iwsdk-debug/SKILL.md +69 -91
- package/dist/guidance/claude/.claude/skills/iwsdk-depth-occlusion/SKILL.md +81 -129
- package/dist/guidance/claude/.claude/skills/iwsdk-dev/SKILL.md +45 -0
- package/dist/guidance/{agents/.agents/skills/iwsdk-planner → claude/.claude/skills/iwsdk-dev}/references/api-reference.md +53 -45
- package/dist/guidance/claude/.claude/skills/iwsdk-dev/references/iterate.md +239 -0
- package/dist/guidance/claude/.claude/skills/iwsdk-dev/references/planner.md +303 -0
- package/dist/guidance/claude/.claude/skills/iwsdk-grab/SKILL.md +37 -114
- package/dist/guidance/claude/.claude/skills/iwsdk-hosting/SKILL.md +177 -0
- package/dist/guidance/claude/.claude/skills/iwsdk-hosting/references/existing-hosts.md +181 -0
- package/dist/guidance/claude/.claude/skills/iwsdk-hosting/references/vercel.md +114 -0
- package/dist/guidance/claude/.claude/skills/iwsdk-native-xr-test/SKILL.md +246 -0
- package/dist/guidance/claude/.claude/skills/iwsdk-physics/SKILL.md +92 -78
- package/dist/guidance/claude/.claude/skills/iwsdk-physics/references/tuning-and-config.md +15 -1
- package/dist/guidance/claude/.claude/skills/iwsdk-pwa-packaging/SKILL.md +218 -0
- package/dist/guidance/claude/.claude/skills/iwsdk-pwa-packaging/references/app-modes.md +104 -0
- package/dist/guidance/claude/.claude/skills/iwsdk-pwa-packaging/references/bubblewrap.md +219 -0
- package/dist/guidance/claude/.claude/skills/iwsdk-pwa-packaging/references/manifest-and-icons.md +149 -0
- package/dist/guidance/claude/.claude/skills/iwsdk-pwa-packaging/references/store-upload.md +104 -0
- package/dist/guidance/claude/.claude/skills/iwsdk-pwa-packaging/references/troubleshooting.md +178 -0
- package/dist/guidance/claude/.claude/skills/iwsdk-ray/SKILL.md +45 -136
- package/dist/guidance/claude/.claude/skills/iwsdk-ui/SKILL.md +251 -157
- package/dist/guidance/claude/CLAUDE.md +2 -141
- package/dist/guidance/codex/.codex/config.toml +1 -1
- package/dist/guidance/common/AGENTS.md +96 -37
- package/dist/guidance/copilot/.github/instructions/scene-json.instructions.md +6 -4
- package/dist/guidance/cursor/.cursor/rules/scene-json.mdc +6 -4
- package/dist/guidance/scoped-agents/public/scenes/AGENTS.md +6 -4
- package/dist/template/common/README.md +13 -0
- package/dist/template/common/public/ui/welcome.uikitml +0 -19
- package/dist/template/common/src/robot.ts +5 -0
- package/dist/template/common/vite.config.ts +18 -0
- package/dist/template/common-js/README.md +13 -0
- package/dist/template/common-js/public/ui/welcome.uikitml +0 -19
- package/dist/template/common-js/src/robot.js +5 -0
- package/dist/template/common-js/vite.config.js +18 -0
- package/package.json +8 -7
- package/scripts/verify-release-ready.mjs +25 -0
- package/dist/guidance/agents/.agents/skills/iwsdk-planner/SKILL.md +0 -364
- package/dist/guidance/agents/.agents/skills/iwsdk-planner/references/build-milestones.md +0 -243
- package/dist/guidance/agents/.agents/skills/iwsdk-planner/references/design-deck.md +0 -101
- package/dist/guidance/agents/.agents/skills/iwsdk-planner/references/grounding.md +0 -176
- package/dist/guidance/agents/.agents/skills/iwsdk-planner/references/ideation.md +0 -156
- package/dist/guidance/agents/.agents/skills/iwsdk-planner/references/verification.md +0 -199
- package/dist/guidance/agents/.agents/skills/iwsdk-scene-composer/SKILL.md +0 -257
- package/dist/guidance/agents/.agents/skills/iwsdk-scene-composer/agents/openai.yaml +0 -4
- package/dist/guidance/agents/.agents/skills/iwsdk-scene-composer/references/asset-authoring.md +0 -295
- package/dist/guidance/agents/.agents/skills/iwsdk-scene-composer/references/composition-patterns.md +0 -243
- package/dist/guidance/agents/.agents/skills/iwsdk-scene-composer/references/review-and-stop.md +0 -99
- package/dist/guidance/claude/.claude/skills/iwsdk-planner/SKILL.md +0 -364
- package/dist/guidance/claude/.claude/skills/iwsdk-planner/references/build-milestones.md +0 -243
- package/dist/guidance/claude/.claude/skills/iwsdk-planner/references/design-deck.md +0 -101
- package/dist/guidance/claude/.claude/skills/iwsdk-planner/references/grounding.md +0 -176
- package/dist/guidance/claude/.claude/skills/iwsdk-planner/references/ideation.md +0 -156
- package/dist/guidance/claude/.claude/skills/iwsdk-planner/references/verification.md +0 -199
- package/dist/guidance/claude/.claude/skills/iwsdk-scene-composer/SKILL.md +0 -257
- package/dist/guidance/claude/.claude/skills/iwsdk-scene-composer/agents/openai.yaml +0 -4
- package/dist/guidance/claude/.claude/skills/iwsdk-scene-composer/references/asset-authoring.md +0 -295
- package/dist/guidance/claude/.claude/skills/iwsdk-scene-composer/references/composition-patterns.md +0 -243
- package/dist/guidance/claude/.claude/skills/iwsdk-scene-composer/references/review-and-stop.md +0 -99
- /package/dist/guidance/agents/.agents/skills/{iwsdk-scene-composer → iwsdk-compose-scene}/references/image-intake.md +0 -0
- /package/dist/guidance/claude/.claude/skills/{iwsdk-scene-composer → iwsdk-compose-scene}/references/image-intake.md +0 -0
package/dist/guidance/claude/.claude/skills/iwsdk-scene-composer/references/composition-patterns.md
DELETED
|
@@ -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.
|
package/dist/guidance/claude/.claude/skills/iwsdk-scene-composer/references/review-and-stop.md
DELETED
|
@@ -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.
|
|
File without changes
|
|
File without changes
|