Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
12 changes: 11 additions & 1 deletion .claude/skills/author-recipe/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -83,7 +83,17 @@ features → secondary forms → tertiary detail and wear. 500–1,500 lines for

## Contact sheet layout
Row 1: 3/4 FRONT · FRONT +X · SIDE -Y. Row 2: TOP · 3/4 REAR · FAR LOD2. Header: name, overall
dimensions, grid step, LOD. Grid = ground plane, step chosen from the asset size.
dimensions, grid step, LOD. Grid = ground plane, step chosen from the asset size. Colour is the
hero's base colour, flat per triangle (the strip's mean albedo × vertex colour; glass see-through;
cutout cards alpha-tested, so leaves and fur show their real silhouette): a part that is white in the
sheet is white in the GLB. Grain, joints and relief show only in `hero.png`.

**Hero view.** The hero camera is a front-left 3/4 orbit. When that hides the point of the asset,
record the view in the recipe: `hero: { azDeg: 145, elDeg: 25 }` (same degrees as `--az` / `--el` /
`--fov`; turn the worn or detailed side to the lens) or a fixed viewpoint for a place,
`hero: { eye: [x, y, z], target: [x, y, z], fovDeg: 50 }` (metres in the asset frame, no
auto-framing). `t3d hero`, `bun run shots`, `t3d review` and `t3d critique` use it by default; a
flag still overrides it. The contact sheet, blueprint and icons keep their fixed views.

## QA gates (all must pass at every LOD)
| Gate | Fails when | Fix |
Expand Down
1 change: 1 addition & 0 deletions .claude/skills/blender-artist/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -73,6 +73,7 @@ distance uneven: stroke after `voxelRemesh` or on the `retopo` shell when a raw
| A cage wider than the gap between parts | fingers bake each other: use `cageFit`, or lower `cage` and `maxRay` |
| Voxel finer than a generator's tunnels | floods the inside into confetti: let `retopo` measure, or set `voxel` and `close` |
| Bone heat on nearby limbs | it reads distance, not anatomy: `unweb` first, then `isolate` chains |
| A chain generated fused to the body along its length (a tail lying on a thigh) | `unweb` cannot cut it and a hard `isolate` split stretches the joining edges: give `isolate` a `contact` distance (metres, start at 0.04) so the band shares the motion; check stifle volume does not drop |
| Decimating code-built geometry | never; only imported or model-built meshes (ADR 011, ADR 016) |
| GPU work | one job at a time on the shared GPU; `--software-gpu` reviews through lavapipe |

Expand Down
4 changes: 2 additions & 2 deletions .claude/skills/creature-artist/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -98,7 +98,7 @@ Sources: [examples/neural-server/README.md](../../../examples/neural-server/READ
Albedo keeps the generator's baked light. A gallop can exceed what the skin takes: drop it and let QA `deform`
judge. Outputs are not bit-identical between GPU runs: the committed output is the input to the build. As of
2026-11 the quadruped example is [`recipes/wolf_hybrid`](../../../recipes/wolf_hybrid/README.md) (read its steps table), and
[`recipes/bear_hybrid`](../../../recipes/bear_hybrid/README.md) for a heavy plantigrade build (`nose: true`, wrist weights); [`recipes/dragon_hybrid`](../../../recipes/dragon_hybrid/README.md) for an invented winged body the plan cannot describe (`register: 'joints'`, `take` with `'tail'`, rigid wings); the humanoid example is [`recipes/ranger`](../../../recipes/ranger/README.md).
[`recipes/bear_hybrid`](../../../recipes/bear_hybrid/README.md) for a heavy plantigrade build (`nose: true`, wrist weights); [`recipes/dragon_hybrid`](../../../recipes/dragon_hybrid/README.md) for an invented winged body the plan cannot describe (`register: 'joints'`, `take` with `'tail'`, wings as `extra` bone chains with a `flap` clip: `wings.ts`); the humanoid example is [`recipes/ranger`](../../../recipes/ranger/README.md).

## Bodies built from chains
For bodies the creature kind cannot describe, write a `defineBodyPlan` spec: a trunk chain plus child chains, `repeat: { kind: 'mirror' }` for paired fins and `{ kind: 'radial', count: 8, ... }` for arms. Declare `medium: 'water'` for swimmers. Motion comes from sourced numbers, not by eye ([research](../../../docs/research/swim-and-tentacle-animation.md)).
Expand Down Expand Up @@ -205,5 +205,5 @@ skeleton types, staged sculpt, patterns, allometry and wing-loading checks — `
Shipped too: the kind's Armature (`ctx.bone`), a `jaw` part, fibre muscles (`build.muscle`).
Planned (M4, [roadmap](../../../docs/plans/roadmap.md#m4-creatures)): tail and limbs as moving
parts, `pose`/`warp`/`ffd`, fur shells and cards, skins and morph targets.
Model tier shipped (As of 2026-11): textured parts (ADR 016), the `blender` step task, `importModel`, `modelChain` / `defineModelCreature`, QA `model`. Planned: wing bones, gallop, jaw and blink on a model body, finger bones.
Model tier shipped (As of 2026-11): textured parts (ADR 016), the `blender` step task, `importModel`, `modelChain` / `defineModelCreature`, QA `model`. Bones the plan lacks (wings, fins, a second tail) are `extra` chains on `modelChain` (joints along the mesh, limits with a source, a `motion` clip). Planned: gallop, jaw and blink on a model body, finger bones.
Neutral positioning: the free code-based option, no claims against other tools.
3 changes: 3 additions & 0 deletions .claude/skills/material-artist/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,9 @@ Use with [11-materials-authoring](../../../docs/idea/11-materials-authoring.md),
[surfaces-volumes research](../../../docs/research/surfaces-volumes.md) and
[16-art-as-text](../../../docs/idea/16-art-as-text.md). One material per asset: everything lands on
the shared trim sheet + vertex colour; extra slots only via `paint`, `finishes`, `optics`, surfaces.
The sheet's 14 custom rows are per asset: define as many materials as the work needs, an asset
maps onto at most 14, one per row (two on one row in one asset: `T3D_MATERIAL_CONFLICT` from
`compile`, give one a free `row`); other assets may reuse any row. Paint with `sheetFor(compiled)`.

## When
A new strip or library material, a texture graph, a weathered variant, a palette, a finish, glass
Expand Down
15 changes: 10 additions & 5 deletions .claude/skills/presentation-artist/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,16 +17,16 @@ image, or adding lamps/headlights to an asset.
## Workflow
| # | Presentation stage | ts23d | Exit |
|---|---|---|---|
| 1 | Neutral look first: orthographic views on a metre grid | `bun run t3d shot recipes/x/x.ts --out renders` → READ `sheet.png` | silhouette right in six views |
| 1 | Neutral look first: orthographic views on a metre grid | `bun run t3d shot recipes/x/x.ts --out renders` → READ `sheet.png` (flat-shaded in the hero's base colour: strip mean albedo × vertex colour, glass see-through, cutout leaf/fur cards alpha-tested to their real silhouette; no texture detail, shadows, AO or emission) | silhouette right in six views; base colours agree with `hero.png` |
| 2 | Hero camera: 3/4 front, slightly above eye level | `bun run t3d hero … --az -35 --el 18 --fov 30 --size 1600x900` (defaults) | asset fills ~60–80 % of frame width *typical* |
| 3 | Pick the view that sells the design | vary `--az` (front-left 3/4 default; rear 3/4 for engines/exhausts), `--el` low for heroic scale, high for top detail | focal part faces camera |
| 3 | Pick the view that sells the design | vary `--az` (front-left 3/4 default; rear 3/4 for engines/exhausts), `--el` low for heroic scale, high for top detail; then record it in the recipe: `hero: { azDeg, elDeg, fovDeg }`, or for a place a fixed viewpoint `hero: { eye, target, fovDeg }` (metres, asset frame). `t3d hero`, `bun run shots`, `review` and `critique` then use it by default; flags still win | focal part faces camera; the committed hero is that view |
| 2b | Judge under physical light | `bun run t3d hero … --quality path --spp 64` (path tracer: sun + sky, bounces, skin diffusion, strand lobes on fur/hair cards; same camera and studio) | fur, skin, metal read as themselves; committed heroes are path traced (960×540, 16 spp) |
| 3b | Textured parts (model-built assets) | the raster beauty, the path tracer and `sheet.png` sample the part's own albedo, normal and ORM (ADR 016); READ them to judge baked light, blotches and seams that vertex colour never shows; `t3d blender review --views turnaround` shows the base colour under studio light before the build | no baked shadow in the albedo, no visible UV seam |
| 4 | Check values: squint / greyscale | read `hero.png`; critique rubric `materials` | distinct value groups; focal part has max contrast |
| 5 | Relief check under grazing light | `t3d critique` → `raking.png`, `raking_detail.png` | modelled detail casts shadow; painted detail stays flat |
| 6 | Distance check | `review/` LOD strip (`lodStrip`), `sheet.png` FAR LOD2 cell, `thumbnail` | reads at thumbnail size |
| 7 | Machine review | `t3d review` → `review.json` warnings (exposure, tiny-in-frame, LOD popping) | no warning you cannot explain |
| 8 | Lights the asset carries | `ctx.socket('headlamp_l', { kind: 'light', dir, data: { light: 'spot', color, intensity, range, cone } })` → KHR_lights_punctual; `glow` for emissive parts | lamps light the scene in engines |
| 8 | Lights the asset carries | `ctx.socket('headlamp_l', { kind: 'light', dir, data: { light: 'spot', color, intensity, range, cone } })` → KHR_lights_punctual; `glow` for emissive parts (both beauty renders show the emission: colour × strength added to the surface, seen through glass tinted by it; strength above ~1.5 on a large face clips to pale yellow-white, as in an engine without bloom) | lamps light the scene in engines; glowing parts keep their hue in `hero.png` |
| 9 | Publish | `bun run shots <name>` (refreshes committed `out/<asset>/hero.png`, `sheet.png`, `thumb.png`) | recipes gate sees current images |

## Vocabulary → measurable
Expand All @@ -36,7 +36,8 @@ image, or adding lamps/headlights to an asset.
| Fill | lifts shadows; key:fill ratio 2:1 commercial, 4:1 portrait, 8:1 dramatic | fixed studio rig; judge shadow detail |
| Rim | back light separating silhouette from background | not separately controllable (gap) |
| Raking light | light at ~80° incidence to show relief | `raking.png` in critique |
| Azimuth / elevation / FOV | camera angle from front (+X), height angle, vertical field of view | `--az`, `--el`, `--fov` |
| Azimuth / elevation / FOV | camera angle from front (+X), height angle, vertical field of view | `--az`, `--el`, `--fov`; per asset `hero: { azDeg, elDeg, fovDeg }` |
| Viewpoint | a camera standing at a real place, looking at a landmark | `hero: { eye, target, fovDeg }` (no auto-framing; the raster drops triangles that cross the eye plane, the path tracer does not) |
| Framing | subject size in frame; too small = `tiny-in-frame` warning | `review.json` |
| Exposure | no clipped whites, no crushed blacks on the subject | `review.json` exposure warning |
| Value grouping | 3–5 clear value masses; focal part highest contrast | **planned** focal check; judge by eye |
Expand Down Expand Up @@ -84,7 +85,11 @@ Shipped: `t3d shot | hero | review | critique | blueprint | gaps`, `contactSheet
`thumbnail`, `lodStrip`, `reviewPack`, light sockets → KHR_lights_punctual, `glow`,
`pathHero` / `t3d hero --quality path` (deterministic CPU path tracer, procedural sky IBL + sun),
`skin` / `skin_*` finishes → KHR_materials_diffuse_transmission + volume in the GLB.
Planned: HDRI environments, glow/emission and clearcoat-only parts in the path tracer (sheen,
`glow` emission in both beauty renders (the path tracer also lets it light its neighbours, by
BSDF sampling: noisy for a small bright emitter at 16 spp), per-asset `hero` view.
See-through parts dim the sun on what they hold in the raster (one shade per render, no coloured
shadow) and cast no shadow in the path tracer.
Planned: HDRI environments, emitters sampled as lights and clearcoat-only parts in the path tracer (sheen,
anisotropy, iridescence are raster-only today), custom light rigs (rim control),
turntable/animated presentation, zebra reflection renders, `photoMatch` side-by-side with
reference photos (stub throws `T3D_NOT_IMPLEMENTED`), greyscale focal-point check.
Expand Down
1 change: 1 addition & 0 deletions .claude/skills/rigger-animator/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,6 +35,7 @@ weights with Blender steps, not `ctx.bone` + `skinWeights`.
| Need | Do | Check |
|---|---|---|
| Quadruped skeleton | our sourced plan fitted INTO the mesh (`fitSkeleton`: legs on each leg's centre line, spine under the dorsal line); optional learned joints: `modelChain({ rig: 'unirig' })`, mapped by topology | QA `model`: every joint inside the mesh (`T3D_MODEL_SKELETON`), mesh hugs the bones (`T3D_MODEL_FIT`) |
| Bones the plan lacks (wings, fins, a second tail) | `modelChain({ extra })`: per chain a name (`wing_l`), the plan bone it hangs from, joints root to tip along the mesh (`tracePath` finds a spar's centre line), a limit per bone with its source, and a `motion` (own clip + idle and gait parts). `bind` weights them with the rest; nothing in the rigger's output is needed | QA `model` (joints inside), `deform` at each declared limit, `skin` (`T3D_SKIN_CROSSED`: beyond the wrist a wing is one side's); a skin with an undeclared bone is `T3D_MODEL_SKELETON` |
| Humanoid skeleton | the model's own (hosted rig: Meshy `rig` with `height`); `bind: { from: 'source' }` keeps its weights and clips | no vertex unweighted, <= 4 influences (Blender report) |
| Gait clips (quadruped) | the creature clips (`idle`, `look`, `walk`, `trot`, `gallop`) baked on the fitted bones; `bite` and `blink` are dropped (fused head, no jaw or lids); `drop: ['gallop']` when the skin cannot take it | QA `deform` poses the skin at the limits; QA `gait` seam, slide, sink |
| Humanoid clips | library clips by name (`Idle`, `Casual Walk`, `Run 2`) renamed `idle`, `walk`, `jog`; `importModel` closes a cycle one frame short and warns; `lift` raises a root that sinks | `gait`: skin of a foot <= 3 mm under the floor in in-place clips |
Expand Down
Loading