Requirements Management
Upload requirement documents to ContextQA and let AI generate test cases, analyze coverage gaps, and track change history — all from a single Requirements Library.
Who is this for? QA engineers, testers, and product managers who want to generate test cases from requirement documents and track coverage gaps automatically.
Overview
The Requirements Library is a centralized workspace where you upload requirement files, review AI-generated questionnaires, monitor test case generation, and inspect coverage gaps. Each uploaded file gets a dedicated Requirements Details page with six tabs that give you full visibility into how your requirements map to test cases.
Opening the Requirements Library
Navigate to test development
Open https://app.contextqa.com and sign in to your workspace. Select Test Development from the left sidebar.
Requirements Library table
The table displays one row per uploaded file with the following columns:
Name
File name prefixed with a requirement ID (e.g., REQ-42). Click the name to open the Requirements Details page.
Type
File type — Requirements or Test case — with a platform icon (Web, Mobile, or API).
Status
Current processing status displayed as a colored badge.
Estimated Time
Time taken to process the file.
Test Cases
Number of generated test cases (visible when status is Completed).
Created by
The user who uploaded the file.
Created Date
Date and time of upload.
Status values:
Completed
Processing finished — test cases are ready for review.
Pending action
The AI needs clarification before generating test cases. Click the row to answer the AI questionnaire.
Processing / In progress
File is being analyzed. You can continue working — ContextQA notifies you when generation completes.
Failed / Error
Processing failed. Check the error details and re-upload if needed.
Table features:
Search — Filter files by name or ID.
Filters — Filter by format, status, date range, or test plan.
Auto-refresh — Automatically reload the table to check for status updates.
Upload requirement button — Start a new upload directly from the library.
Uploading a requirement file
Upload your file
Drag and drop or click to browse. Accepted file types depend on the mode and platform:
Import Test Cases
All
.xlsx, .xls
Import Requirement
Web / Mobile
.xlsx, .xls, .flv, .mov, .mpeg, .mpg, .mp4, .webm, .wmv, .3gp
Import Requirement
API
.json
Video files have a maximum size of 1 GB and a maximum duration of 30 minutes.
Select a publish mode
Choose how generated test cases are handled after analysis:
Require Approval (default)
Generated test cases are saved in a pending state. You must manually review and approve them from the Test Cases tab before they are published. The Create Test Suite, Create Test Plan, and Execute Test Plan options are disabled in this mode.
Auto Publish
Generated test cases are published immediately after analysis. You can optionally configure test suite, test plan, and execution settings (see next step).
Publish mode is available in Import Requirement mode only. When you select Require Approval, use the Approve All or Reject All buttons on the Test Cases tab to manage generated test cases (see Test Cases tab).
Configure optional settings
These options are available when Auto Publish is selected as the publish mode:
Create Test Suite
Automatically group generated test cases into a new test suite. Enter a suite name.
Create Test Plan
Create a test plan for the generated cases. Enter a plan name. Automatically enables test suite creation.
Execute Test Plan
Run the test plan immediately after generation. Available when Create Test Plan is enabled.
Start generation
Click Create Test Cases. ContextQA uploads the file and begins processing.
If the AI needs clarification, the AI questionnaire opens automatically (see Answering the AI questionnaire).
Otherwise, ContextQA generates test cases in the background. The file appears in the Requirements Library with status Processing.
When the Figma feature is enabled on your plan, you can select Figma as the source instead of uploading a file. Enter a Figma file URL (e.g., https://www.figma.com/file/... or https://www.figma.com/design/...).
Answering the AI questionnaire
When the AI determines that your requirements need clarification, it generates a set of questions. This happens either automatically after upload or when you click a file with Pending action status.
The questionnaire dialog displays:
The file name and the AI's initial analysis message
One or more clarification questions, each with context explaining why the question is relevant
Type your answer for each question in the provided text area. Then:
Click Submit to send your answers and continue generation.
Click Skip & Generate Test Cases to proceed without answering. This option is available only before you enter any answers.
After submission, a confirmation message appears: "The requirements are currently being processed. Please review the test cases once they are ready."
Requirements Details page
Click any file in the Requirements Library to open its Requirements Details page. The header displays:
File name and processing status
Metadata (file type, test type, requirement code, creator, date)
Test case count and type badges (Positive, Negative, Edge)
Actions menu with View Details, Download Original, Export Test Cases, Re-import / Update, and Delete
Below the header, six tabs provide different views of the requirement.
Test Cases tab
The default tab. Displays all test cases generated from the requirement file in a searchable, filterable table.
While generation is in progress, a progress indicator shows:
Percentage complete and estimated time remaining
A message confirming that generation runs in the background
After generation completes, the table shows each test case with:
Name and description
Steps count
Variables
Type (Positive, Negative, Edge, Functional, Boundary Value, End to End, Field Validation)
Status (New or Duplicate)
Available actions:
Search test cases by name
Filter by type or status
Approve All or Reject All to batch-manage generated test cases
Click a test case row to open a detail drawer with full step information
Table row actions:
View, edit, or delete individual test cases from the row action menu
Questionnaire tab
Displays the AI-generated questions and your answers from the clarification step.
Each entry shows:
The question text
Your answer (or a note that the question was skipped)
Use this tab to review what context the AI used when generating test cases. If a question was skipped, a placeholder indicates: "Question skipped. Regenerate the test case to add an answer."
AI Analysis tab
Shows the AI's analysis of your uploaded requirements, organized into four sections:
AI Understanding
A summary of how the AI interpreted your requirements document.
Assumptions Made
A numbered list of assumptions the AI made during analysis.
Coverage Notes
Areas covered by the generated tests, with a summary and bullet-point details.
Warnings & Gaps
Areas that may need attention — flagged with warning indicators.
A Confidence Score (0–100%) indicates how confident the AI is in its analysis. Higher scores mean the requirements were clear and complete.
History tab
This tab is coming soon. It will display a timeline of changes made to the requirement file, including re-imports, test case modifications, and status transitions.
Metadata tab
Displays detailed information about the uploaded file in three sections:
File information:
File Type
Format of the uploaded file (e.g., XLSX, JSON, MP4)
File Size
Size of the uploaded file
Page Count
Number of pages in the document
Word Count
Total word count
Version
Current version number
Configurations:
Test Plan
Associated test plan name (if created during upload)
Test Suite
Associated test suite name (if created during upload)
Platform
Target platform (Web, Mobile, or API)
Browser / Mobile Device
Target browser or mobile device
Timestamps:
Created By
User who uploaded the file
Created At
Upload date and time
Last Modified
Date and time of the most recent change
Labels: Any tags applied to the requirement file.
Gaps tab
Identifies coverage gaps between your requirements and the generated test cases. The page displays each gap as a card in a two-column grid.
Each gap card shows:
Title — A short description of the missing coverage area
Similarity score — How closely the gap relates to existing test cases (displayed as a progress bar)
Tags — Requirement ID, test case priority, test case type, and prerequisite warnings
Why missing — An explanation of why this area lacks coverage
Click View details on any gap card to open a detail drawer with:
Similarity score — A visual ring chart with a description of the score level
Summary — Detailed explanation of the gap
What's missing — A numbered list of specific items not covered
Suggested test cases — AI-recommended test cases to close the gap
Gap drawer actions:
Add individual suggested test cases to your project
Add All Suggestions to close the gap at once
Dismiss the gap if it is not relevant
Row actions in the Requirements Library
Right-click or use the action menu on any file in the Requirements Library for quick actions:
View Details
Open the Requirements Details page
Download Original
Download the originally uploaded file
Export Test Cases
Export generated test cases
Re-import / Update
Upload a new version of the requirement file
Delete
Remove the requirement file and its generated test cases
Related documentation
Creating Test Cases — All test case creation methods including file import
AI Test Generation — All 10 AI test generation methods
Managing Test Suites — Organize test cases into suites
Test Data Management — Variables and data-driven testing
Last updated
Was this helpful?