Decide where the work belongs
Name the action cost
Describe what a person expects and what the current action actually does. Compare review, acknowledge, navigate, and destructive outcomes. Keep a missing destination separate from a label that is merely too broad.
Compare action sizes
Set concise labels, destination context, inline completion, one safe action, and no action beside one another. Consider permission and state changes. Prefer the smallest action that completes a predictable task without implying authority the person lacks.
Choose the first slice
Record event type, state, owner, and revisit evidence. Decide whether to improve label, destination, state fallback, or action availability. Preserve the current path and one no-action control for comparison. Name the context a person should see next.
What to carry forward
Prioritize action changes where a meaningful task is hidden or a generic button causes wrong navigation. The decision should name outcome and destination scope. If the action already predicts its result, queue the specific stale-state or delivery gap instead.
Technical background: Apple developer documentation.
Keep the decision with the work.
Use a Work Item in Aglet to record the problem, the evidence you have, and the next decision. Add an owner and priority, then keep updates in the discussion so the next person can follow the reasoning.
Create an account See the product workflow