docs(readme): end-to-end demo GIF - prompt to SolidWorks part to reproduction script #147

Goal

The README is a wall of text. Show what the MCP server can do with an end-to-end demo: a prompt goes in, the model calls tools, SolidWorks builds the part, and a Python script that reproduces it comes out.

The demo

One recorded session, shown as a GIF (or short video) at the top of the README:

1. Prompt. Something like "Design a mounting bracket for a NEMA 17 motor, 3D-printable." Show which model ran it.
2. Specs. The model asks for what's missing (wall thickness, hole clearance, printer) and the user answers.
3. Tool calls. Each call, with its input and result, next to SolidWorks after that step: sketch, extrude, holes, fillets, material, mass check.
4. Drawing. A drawing with model dimensions, laid out without overlaps (insert_model_dimensions, arrange_dimensions, feat(tools): drawing-dimension tools from #117 (insert_model_dimensions, arrange_dimensions) #146), exported to PDF.
5. Script. The Python script that reproduces the part, from the session's tool calls.

Aim for a sequence that uses as many tool groups as makes sense (modeling, sketching, features, engineering data, drawings, export) without dragging.

Building on what exists

The live demo capture added in #139 and #146 already does most of this:

• tests/live/evidence.py captures the SolidWorks window at each step and adds a caption with the tool call and its colour-coded result.
• tests/scripts/make_demo_gif.py turns those frames into a GIF.

Still needed:

• evidence() takes prompt and model fields and shows them on the first frame.
• A way to record a real session (Claude Code or Claude Desktop): the prompt, the model, every tool call and its result. One option is to log them from the server's tool boundary.
• Generate the reproduction script from that log, or from a VBA/Python generator tool.
• Pick the demo part and its prompt, then run it live and check every step.
• README: put the GIF near the top, followed by a short capability tour (a few smaller GIFs or stills per tool group), with the tool list after.

Related

• docs: SoC tutorial, end-to-end demo, and best-practices guide #31: tutorial, end-to-end demo and best-practices guide
• docs(examples): prompt-to-SolidWorks tutorials + free SimulationXpress walkthroughs #80: prompt-to-SolidWorks tutorials
• feat(ui): CADAM-inspired live tool-call render panel (chat + live SolidWorks state view) #44: live tool-call panel next to SolidWorks