# React Guidance

- Preserve the existing design system and interaction patterns unless the task explicitly changes them.
- Keep component boundaries intentional; move complex state or effects out of leaf UI where possible.
- Test user-observable behavior rather than implementation detail.
- Verify loading, empty, error, and success states when the UI surface changes.
- Update docs or notes only when the component contract or usage changes.