The short answer
Add weight when the last session told you there was room: you reached the top of your rep range on every working set, or you finished with more reps in reserve than you planned to leave. If neither happened, the weight stays and you chase reps instead.
Two signals, not one
Reps alone are a blunt instrument. Three sets of ten at the top of your range could have been brutal or easy, and the right next step is different in each case. Effort alone is just as blunt, because a hard set of four in a range that asks for ten means the weight is wrong, not that you are progressing.
Read them together. Reps at the top and effort below what you planned is the clearest add-weight signal there is. Reps at the top with nothing left in the tank means hold, and take the reps you earned.
How much to add
Not a fixed number. The right step is a fraction of what you are already lifting, and it is bounded by what your gym can actually load. A 10 kg dumbbell and a 100 kg barbell should never take the same jump, and on a machine with a 5 kg stack you have no smaller choice anyway.
Work from the smallest increment you can genuinely load for that lift, and take one of them. If your smallest plates are 1.25 kg a side, your step is 2.5 kg.
When not to add weight
A session you cut short is not evidence. Neither is a lift you have not touched in three weeks: the first one back is a re-introduction, not a test.
Two sessions under target in a row is a sign to go the other way. One short session is noise - a bad night, a skipped meal, a cold gym. Two in a row is a pattern, and a deliberate lighter session now is cheaper than a stall later.
How REGOL decides
It reads your last session and proposes the next weight for every lift, with the reasoning in plain words next to it. More in reserve than planned: more reps first, then weight once the reps are at the top. More than your top number on every set: weight up, however hard it felt. Exactly as planned: same weight, one more rep - unless every set was already at the top, and then it goes up.
How far up is read from your own sets and snapped to the step size you set for that lift, so it only ever asks for a weight you can load. Come in under target twice and it offers a lighter session before you stall. One tap overrules any of it.
A lift can follow a different rule if you want one. Double progression goes by reps alone. Linear adds a step every session regardless of what happened.
Related: what reps in reserve means and what progressive overload is.
REGOL works out weights from what you logged. It is arithmetic, not coaching, and not medical advice. Train within your ability.