Pages and contents

Docs
Skills
Subagents
Lessons (pitfalls)
Research

Skills · skills/cad-motion-validation/SKILL.md · Markdown

Validate the rendered mechanism

A CAD interference sweep does not validate a browser's scene graph. Establish independent mechanical intent, capture the actual rendered transforms, and compare them before claiming the simulation is correct.

Scroll sideways to see the full diagram →

1 inventory joints + parts
from CAD, not the animation

2 reference landmarks;
capture the real renderer

3 motion-trace
worst point, pivot, radial error

4 more events; a planted
wrong pivot must fail

5 pair with the CAD gates,
record the limits

Diagram source
flowchart TD
    I["1 inventory joints + parts<br/>from CAD, not the animation"] --> Ref["2 reference landmarks;<br/>capture the real renderer"]
    Ref --> T["3 motion-trace<br/>worst point, pivot, radial error"]
    T --> E["4 more events; a planted<br/>wrong pivot must fail"]
    E --> P["5 pair with the CAD gates,<br/>record the limits"]
    class Ref,T,E here
    class I near
    class P out
    classDef here fill:#fffdf5,stroke:#173d3c,color:#173d3c
    classDef near fill:#eef1e4,stroke:#6f8a80,color:#173d3c
    classDef out fill:#ffe1cc,stroke:#bd3a12,color:#173d3c
  1. Inventory all moving joints and components, including shafts/rotors, stationary housings, feed mechanisms, helper geometry and scene attachments. Record ownership, units, axis handedness, home datums and parent chains from CAD source or inspected geometry. Do not take the expected pivots from the suspect animation manifest.
  2. Read the trace protocol. Build a reference with at least four noncoplanar landmarks per component. Drive the real renderer using cad-agent motion-trace reference.json --poses-only, then capture actual mesh vertices through its current world matrices in the common assembly frame, in mm.
  3. Run cad-agent motion-trace reference.json capture.json --output motion-report.json. Inspect the worst-point, pivot-anchor and radial errors. Compare axes to physical shaft/bearing geometry; rest-pose agreement and rigid within-mesh distances alone cannot catch a wrong orbit. Keep fixed housings attached to their support.
  4. Add captures for firing/operation, combined independent joints, stop/start, repeated cycles and scene transitions. Reproduce a wrong pivot with correct home placement and require failure. Also exercise units, axis/sign, lost-parent and ownership errors. Keep regression checks in the existing product build/test harness.
  5. Pair kinematic checks with CAD motion/containment gates and visual inspection of the actual published renderer. Record input/export hashes, tolerance, sample density, untested events and independent reference provenance. A passing trace says nothing by itself about continuous clearance, loads, physical fit or hardware safety.

Use the repository's normal independent review and deployment process. This skill adds no publication permission.