A step turned red after I changed a parameter
What a red step means, what each error type tells you, and how self-healing history lets the agent explain and repair the break.
Follow along
Enclosure example
You dragged a slider, and a step in the Recipe turned red. The model might look broken or half-built. Take a breath: this is a normal part of parametric design, and Solid Vibes is built to help you recover.
What "red" means
A red step means: with the new values, this step could not do its job. It does not mean your work is lost. The step is still there, still editable, and the history is intact. Undo takes you straight back.
Each failed step explains itself in plain language, naming the numbers involved. For example: "The fillet radius (6 mm) is larger than the 4 mm wall."
Symptom
- A step in the Recipe is red, with a message.
- The model looks different from what you expect, with a feature missing or unchanged.
- A design intent chip turned red (a different thing: see below).
- The agent says a step "failed" and proposes a repair.
What each kind of error means
| Message in plain words | Technical cause | Typical trigger |
|---|---|---|
| Nothing was selected | A selector matched no faces or edges | A feature moved or vanished, so the thing the step refers to is gone |
| The fillet could not be built | Radius too large, or edges too close | Wall got thinner, radius increased |
| The shell could not be built | Wall thicker than the part can hold, or faces cannot be offset | Wall bigger than half the thinnest section |
| The boolean failed | A union, cut or intersect produced nothing or invalid geometry | Two bodies no longer overlap, or touch only at a face |
| A reference is missing | The step points to another step, sketch or body that no longer exists or is suppressed | A step upstream was suppressed or moved |
| There is a formula error | A typo, unknown name, or division by zero | A parameter was renamed or set to zero |
| The profile is invalid | A sketch is self-intersecting or not closed | A dimension made lines cross |
| The geometry engine hit a problem | A rare engine exception | An edge case, handled and isolated |
| It took too long | The step timed out | Huge pattern counts or very complex shapes |
Self-healing history
When an upstream change breaks a downstream step, the agent can explain what happened and propose a fix, as a ghost preview you can accept, tweak or reject. It does not silently patch.
You can ask for it:
A step went red after I set board_width to 70. Explain what broke and why, and propose the smallest fix. Do not change my parameter.
Typical repairs:
- adjusting a radius or wall to fit the new size,
- changing a selector so it still finds the right edge,
- reordering steps,
- limiting a formula with
minormax, - suppressing a feature that no longer makes sense (never deleting it).
Fix it yourself
- Undo the parameter change to confirm it was the trigger.
- Click the red step and read the message.
- Find the numbers. Often one value has become impossible: a wall of 0.8 mm with a 2 mm fillet, a hole larger than its plate.
- Adjust either side. Change the parameter that went too far, or change the dependent value (reduce the radius).
- Check subsequent steps. A failed step can leave later steps that depended on it looking wrong too. Once the first red step is fixed, the rest usually recover.
- Look for the earliest red step if several are red. Fix that one first.
A red chip is different
A design intent chip turning red means a rule you set no longer holds, for example "walls at least 1.6 mm". The model itself still builds. Decide whether to undo, fix the design, or relax the rule. See Design intent.
How to avoid it
- Set slider ranges (min, max, step) to values that make sense, so you cannot drag into nonsense.
- Use bounded formulas.
min(fillet_radius, wall * 0.8)cannot exceed the wall.max(wall, 1.2)cannot go below 1.2. - Add design intent rules for the limits that matter.
- Select by meaning, not by clicking individual edges.
- Stress-test. After building a model, drag each main parameter to both extremes and see what turns red. Fix those cases once, and they stay fixed.
- Branch before big changes.
- Fillet and chamfer late in the Recipe.
Try it
On the Enclosure template:
- Drag the wall thickness up to its maximum, and watch what turns red.
- Ask:
Explain the red step and fix it so the wall slider can go up to 5 mm without breaking anything.
- Accept the ghost, then drag the slider through its whole range again.
Did this help?
Keep reading
Ideas
The Recipe: your piece's readable history
Every piece is built from a list of plain-language steps. Learn to read it, edit it, and use it to understand any model, including ones you did not make.
Beginner4 min readFor CAD pros
Selectors and topological naming: how Solid Vibes stays robust
Recipes never store face or edge indices. They store semantic queries. Here is the selector vocabulary, why it survives upstream edits, and how to debug an empty match.
Pro4 min readTroubleshooting
The fillet broke
A fillet or chamfer step turned red or produced nothing. The usual causes (radius too large, tangent edges, wrong order) and how to fix each.
Intermediate4 min read