# Wind walker ## What this builds A walking linkage, in the long tradition of wind-walking machines, modelled as code with its own documented constants (not a branded kit's parts). Link lengths, a foot path over a full crank revolution, and clearances are checked so the linkage does not intersect itself. Gait renders at several crank angles are written. Walking on sand, or in wind, is out of scope. Read `spekkr.inputs.json` first. `scale` multiplies the link table. `thickness` and `clearance` size the bars and joints. `legs` and `crank_handle` change how complete the model is. `tool` is the modeller. ## Out of scope - A branded walking-sculpture name in the id or the title. - Walking on sand, or a wind test. - A physical print or a kit of bought parts. ## Requirements Each requirement has an id. Checks name the id they cover. ### R1. Lengths and foot path - Link lengths are the constants in `design.md` times `scale`, within 0.05 mm * scale. - A kinematic model (or the mesh at stepped angles) traces the foot over one crank revolution. The path matches the polyline in `fixtures/walker-foot.json` within 0.5 mm * scale. - At 36 steps of 10 degrees, no two bars illegally intersect, given `clearance` at the joints. Accept when: lengths, the foot path, and the intersection check all match. ### R2. Files and frames - Export the parts or a posed assembly at 0, 90, 180, 270 degrees. Renders: a side view, a foot-path overlay, a top view, and a contact sheet of those angles. - One command builds, traces, checks, and writes the renders. No sand, no wind, no print. Accept when: the command passes for both tools, and a deliberately shortened link fails the path 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 Linkage lengths match documented constants. The foot path and clearances over a full crank revolution are checked, including no illegal self-intersection. Gait renders at several angles are written. Walking on sand is out of scope. No physical print is required. The product name does not use a trademarked walking-sculpture name. ## 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 the constants are listed, and that a walk on sand is not a check.