Skip to main content

Grounded, Safe Instructions

Require Evidence for Claims

Evidence requirements control what the model can claim. When the agent explains a plan, discrepancy, or bug, require file paths, line numbers, concrete values, exact error messages, cited sources, metric names, timestamps, or customer quotes.

Weak claim—pattern completion
The onboarding redesign probably failed because inviting teammates too early added friction.
Grounded claim—retrieval with evidence
The largest drop is at workspace_invite_shown → first_dashboard_view: 62% to 41% in activation_funnel_enterprise for May 14–21. Three support tickets quote confusion about mandatory invites, and the redesign spec lists teammate invitation before dashboard preview.

The second claim is verifiable. If the metric, date range, quote, or spec reference is wrong, you spot the drift immediately. Evidence requirements do not make the model deterministic; they make unsupported claims visible.

Replace Negation With Positive Instructions

Negation is a weak control surface because the model is not applying symbolic rules. It predicts continuations from the whole context, and the forbidden concept is still part of that context. Use "do not" to mark the boundary, then immediately specify the desired behavior in positive, concrete terms.

Risky
Improve onboarding.
Do NOT make the flow confusing.
Better—positive target plus boundary
Improve first-run onboarding.

Do NOT introduce steps that make activation feel blocked.
Instead, keep the first-run path linear and value-first.
Ask for workspace name before teammate invites; show optional setup after dashboard preview; label optional steps as skippable.

The safer pattern states the forbidden outcome, immediately supplies the desired experience, then names the sequencing mechanism. It gives the model a concrete continuation to follow instead of leaving the forbidden concept as the strongest signal.


Next: Executable Validation