# Flexi axolotl ## What this builds An original articulated axolotl, modelled as code: a chain of segments, a head, a tail, and optional gills. Segment clearances and a documented bend envelope are checked so a scripted bend does not cause illegal intersection. Wall thickness is measured. Renders are written. No physical print is required. Read `spekkr.inputs.json` first. `length` sizes the animal. `gap` is the segment clearance. `wall` is the shell. `gills` and `stand` add features. `tool` is the modeller. ## Out of scope - A licensed character, or a commercial model's exact tooling. - A physical print, or a claim of biology. - Paint or electronics. ## Requirements Each requirement has an id. Checks name the id they cover. ### R1. Clearances and bend - At rest, neighbouring segments are clear by `gap` within 0.05 mm. - A scripted bend (`fixtures/axolotl-bend.json`, angles along the chain, within the envelope in that file) produces no illegal intersection. - A bend past the envelope is refused or reported as out of range. Min wall is at least `wall`, except documented thin gill tips down to 1.0 mm. Accept when: rest gaps match, the in-envelope bend is clean, an over-envelope bend is refused, and walls pass. ### R2. Files and frames - A print-in-place mesh (or part files plus a joined rest pose). Renders: rest, bent, a gill close-up, and a logical explode. - One command builds, bends, checks, and writes the renders. No print. Accept when: the command passes for both tools, and the four renders are written. ### 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 Segment clearances and a documented bend envelope are checked so an in-range bend does not intersect illegally. Wall thickness is measured. Rest and bent renders are written. 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 export, how far it may bend, and that a print is optional.