# Action figure ## What this builds An original articulated figure, modelled as code: limbs, a torso, a head, and snap-fit joints with documented axes and clearances. A script poses it (a T-pose and a documented action pose) and checks that parts do not intersect. Minimum wall thickness is measured. Renders are written. The feel of a printed snap is out of scope and is not a check. Read `spekkr.inputs.json` first. `height` scales the figure. `clearance` is the snap gap. `wall` is the shell. `hands` and `stand` add parts. `tool` is the modeller. ## Out of scope - A licensed character, or a commercial figure's tooling. - The tactile feel of a snap, or a physical print. - Paint, fabric, or electronics. ## Requirements Each requirement has an id. Checks name the id they cover. ### R1. Joints and clearances - Each joint has an axis and a snap geometry in `design.md`. In the assembled T-pose, the clearance around the snap is `clearance` within 0.05 mm. - A scripted pose (`fixtures/figure-pose.json`, angles per joint) is applied, and no two solid parts intersect (a mesh collision check, tiny contact at a snap is allowed as in the file). - Minimum wall thickness is at least `wall`, except documented thin features down to 1.0 mm. Accept when: T-pose clearances match, the posed figure has no illegal intersection, and the wall check passes. ### R2. Files and frames - Parts export separately, plus an assembled T-pose and the posed figure. Renders: T-pose, posed, a joint close-up, and an exploded view. - One command builds, poses, checks, and writes the renders. No print, no snap-feel test. Accept when: the command passes for both tools, and a deliberately intersecting pose fails the check. ### R3. Inputs - Numeric inputs are read from `spekkr.inputs.json` and must stay inside the ranges in the Inputs table in `design.md`. - A value outside a range is refused before modelling, with a message that names the key. - Options add or remove the features in that table. The `tool` swap selects CadQuery or OpenSCAD; both must meet the same numbers. Accept when: default and one out-of-range value are handled as above, and a second legal input set still matches the formulas in `design.md`. ### R4. Checks and report - One command builds the model at the defaults and at the person's inputs, measures it against `design.md`, and writes a short report. - A model broken on purpose, for example a wall thinner than `wall`, must fail the report. - The command exports the files this spec asks for (STL, and STEP when the tool can). No physical print is required. Accept when: the report says pass at the defaults and at the person's inputs, and fail on a deliberately broken model. ## Verification Joint axes and snap-fit clearances are measured. A scripted pose is checked for illegal self-intersection. Minimum wall thickness is measured. T-pose and posed renders are written. The tactile feel of a printed snap is out of scope. No physical print is required. ## Definition of done - Every acceptance check above runs from one command, and all pass at the person's inputs. - A README says how to pose the figure, how to export the parts, and that snap feel is not a check.