Research Preview
Research Preview: The Qodo Spec Agent is set as Research Preview and is under active development. Functionality and results may evolve as we continue to improve the feature. We recommend reviewing and validating outputs before use, and advise against using these features in production or business-critical workflows.
How requirement gaps are generated
Requirement gaps are generated by the Qodo Spec Agent, which analyzes pull requests that include a linked specification.
The agent compares the implementation in the pull request against the requirements defined in the specification and identifies any discrepancies.
When a requirement is not fully satisfied, the Spec Agent reports a 📎 Requirement gap finding.
The Spec Agent runs automatically whenever a pull request is opened or updated.
Prerequisites
- Set up a documentation integration. For more information, see Integrate Qodo with Documentation and Design.
- Log in to the Qodo portal.
- Navigate to the Configuration > Research preview tab.
- Verify that Spec agents is enabled.
View the requirement gap in the findings
The Spec Agent adds the following finding type to the review output:
📎 Requirement gap: A requirement defined in the specification is not fully implemented in the pull request.
Requirement gaps appear alongside other review findings:
- 🐞 Bugs
- 📘 Rule violations
- 📎 Requirement gaps
All findings are displayed in a unified review comment.
Requirement gap details
Each requirement gap finding includes:
- Description: Explanation of what requirement is missing or incomplete
- Code reference: Link to the relevant lines in the pull request diff
- Evidence: The specification section used for validation
- Agent prompt: A suggested prompt to help resolve the issue
