Skip to main content
Research Preview
Research Preview: The Qodo Design Review Agent is set as Research Preview and is under active development. Functionality and results may evolve as we continue to improve the feature. Review and validate outputs before use, and avoid using these features in production or business-critical workflows.
The Design Review Agent surfaces findings under the UX Deviations section in the review output. These findings highlight differences between the implementation and the linked Figma design or design system.

​
How UX deviations are generated

UX deviations are generated by the Qodo Design Review Agent, which analyzes pull requests that include a linked Figma design. The agent compares the implementation in the pull request against the designs defined in Figma and identifies any discrepancies. When a design is not fully satisfied, the Design Review Agent reports a 🎨 UX deviation finding. The Design Review Agent runs automatically whenever a pull request is opened or updated.

​
Configure UX deviations

  1. Log in to the Qodo portal.
  2. Set up the Figma integration under Integrations > Documentation & Design. See Integrate Qodo with Figma.
  3. Navigate to Configurations > Finding types.
  4. Enable the Design gaps toggle. Changes are saved automatically.

​
Configure UX deviations in .pr_agent.toml

The portal’s Design gaps toggle shows as off until you interact with it. Until then, this engine default applies regardless.

​
View the UX deviation in the findings

The Design Review Agent adds the following finding type to the review output:
  • 🎨 UX deviation: A design element defined in Figma is not fully implemented in the pull request.
UX deviations appear alongside other review findings:
  • 🐞 Bugs
  • 📘 Rule violations
  • 📎 Requirement gaps
All findings are displayed in a unified review comment.

​
UX deviation details

Each UX deviation finding includes:
  • Description: Explanation of what design element is missing or inconsistent
  • Code reference: Link to the relevant lines in the pull request diff
  • Evidence: The Figma design section used for validation
  • Agent prompt: A suggested prompt to help resolve the issue