UX Requirements Matters: Guidelines to Support Software Teams on the Writing of Acceptance Criteria

  • Suéllen Martinelli UFSCar
  • Nicolas Nascimento PUCRS
  • Jonathan Souza UFSCar
  • Afonso Sales PUCRS
  • Luciana Zaina UFSCar


User Stories (USs) are artifacts that define requirements in agile software development and that are usually complemented by Acceptance Criteria (AC) which provide details about what should be implemented. These details often attempt to integrate User Experience (UX) requirements to their descriptions. This paper aims to introduce a set of guidelines that supports software teams to write UX requirements during the elaboration of AC. The guidelines are separated into Interaction Design (ID) and Visual Elements (VE). We conducted a case study with 10 agile teams that develop mobile applications that used the guidelines during a sprint. After that, we carried out a qualitative analysis of the UX requirements described in the USs/AC to evaluate the usage of the guidelines. We analyzed the guidelines’ acceptance regarding usefulness and ease of use based on feedback from the teams. We analyzed 242 AC and identified that 99 AC had UX requirements related to ID and 87 to VE. We identified that only 7 developers, spread over four teams, reported negative feedback about the guidelines. We conclude that teams were helped by the guidelines that respectively address details about the user’s interaction with the product, as well as the definition of the most adequate visual elements to enable this interaction.
Palavras-chave: Acceptance Criteria, User Stories, Mobile Application Development, User Experience
MARTINELLI, Suéllen; NASCIMENTO, Nicolas; SOUZA, Jonathan; SALES, Afonso; ZAINA, Luciana. UX Requirements Matters: Guidelines to Support Software Teams on the Writing of Acceptance Criteria. In: SIMPÓSIO BRASILEIRO DE ENGENHARIA DE SOFTWARE (SBES), 36. , 2022, Uberlândia. Anais [...]. Porto Alegre: Sociedade Brasileira de Computação, 2022 . p. 398–408.