git:20260907.e8d856f to git:20260908.d7cde2b

---

name: principle-experience-first

description: "Apply when product, UX, or feature-scope tradeoffs come up. Choose user delight over implementation convenience; ship fewer polished features over more rough ones."

disable-model-invocation: true

---

# Experience First

When implementation convenience conflicts with user delight, choose delight.

- Every feature, control, and option must be justified

- Ship less, ship better (polished experience with three features beats rough one with ten)

- Prototype before committing (design decisions are cheaper in throwaway HTML than production code)

- Get the details right (transitions, alignment, spacing, feedback, error states)

- Tighten the core loop (every feature should serve the central workflow or get out of the way)

The user is whoever consumes the work. For a UI that is the end user. For a library or an internal API it is the colleague who imports it. The engineer who maintains the code next is a user too. Weigh their experience the same way, and explain impact from their perspective.