principle-experience-first

Apply when weighing a product, UX or feature-scope tradeoff.

SKILL.md

GitHub

Experience first

The work is judged by the people who consume it.

  • The user is whoever consumes the work: an end user, a colleague importing the module, the next maintainer. Explain impact from their side.
  • When implementation convenience and the consumer's experience conflict, choose the experience.
  • Each feature, control and option earns its place against the core workflow; cut what does not serve it.
  • Ship fewer finished features rather than more rough ones.
  • Interaction details (transitions, alignment, spacing, feedback, error states) are part of the work, finished with it, not left for a later polish pass.