Requirements Library
Upload requirements documents, review AI-generated test cases, analyze coverage gaps, and manage your requirements library in ContextQA.
Quick answer
Upload requirements documents, review AI-generated test cases, analyze coverage gaps, and manage your requirements library in ContextQA. Use this page to understand when the capability applies, complete its user-facing workflow, and verify the expected result.
What this page covers
The Requirements Library lets you manage uploaded requirement files and the test cases generated from them. After you import a requirements document through the Create Test Case dialog, the file appears in the library where you can track its processing status, review generated test cases, inspect AI analysis, identify coverage gaps, and view file metadata.
Opening the requirements library
Select Assets → Requirements from the left sidebar.
The Requirements Library list view opens, showing all uploaded requirement files for the current workspace.
Requirements list view
The list view displays a table of all uploaded files with the following columns:
Id
Numeric identifier for the upload
Name
File name (click to open the detail view)
Type
File format (e.g., EXCEL, CSV)
Status
Current processing status (see below)
Estimated Time
Processing duration
Test Cases
Number of generated test cases
Created by
Team member who uploaded the file
Created Date
Upload date and time
Status values
Completed
Processing finished and test cases are available
Pending action
AI needs clarification before generating test cases
Processing / In progress
File is currently being analyzed
Failed / Error
Processing encountered an error
Use the search bar to filter files by name. The list supports server-side pagination and auto-refresh.
Badges, statuses, and highlights
The badge beside a requirement describes its processing or review state, such as Pending action, Processing, Completed, or Failed. It is distinct from:
A red badge in a coverage view, which marks an unresolved coverage issue.
A selected or visually highlighted row, which only indicates the current UI selection.
Test-case type and decision badges inside Requirements Details.
There is no separate current Requirements control named highlight flag. If instructions use that phrase, identify the visible badge and its surrounding page before acting; do not treat a red coverage indicator as a requirement-processing status.
Answering clarification questions
When a file has the Pending action status, click its name to open a clarification dialog. ContextQA's AI analyzed your requirements and needs additional context before generating test cases.
The dialog displays:
The AI's analysis message explaining what it understood
A list of clarification questions with text fields for your answers
You can either answer the questions and click Submit, or click Skip & Generate Test Cases to proceed without providing additional context.
Requirement detail view
Click any file name in the list to open its detail view. The header displays:
File name and status badge
Metadata row — file type, test type (Web or Mobile), requirement code, creator name, and creation date
Generated test cases count
Filter badges — filter test cases by type (Positive, Negative, Edge, etc.) and status (Approved, Rejected, Pending)
Export button — download the requirement data
Back button — return to the library list
The detail view contains six tabs:
History (coming soon)
Test cases tab
The default tab displays all test cases generated from the uploaded requirement file in a searchable, filterable table.
Table columns
Each test case row displays:
Test Case
Name and inline description (click to open the detail drawer)
Type
Color-coded test type badge (Positive, Negative, Edge, etc.)
Status
New or Existing
Decision
Pending, Approved, or Rejected
Actions
Row action buttons (see Approving or rejecting test cases)
Searching and filtering
Use the search bar to find test cases by name. Click the Filter button to open the filter panel and narrow results by type, status, or priority. Active filters appear as removable chips above the table. Filters persist across navigation within the same session.
Reviewing a test case
Click any test case row to open the test case detail drawer. The drawer contains two tabs — Details and Variables — accessed through the segment control under the header.
Header badges and actions:
Status badge
Current status (e.g., Pending, Approved, Rejected)
Case ID
Unique identifier (UR- prefix for pending, C- prefix for created)
Type badge
Color-coded test type
Decision badge
Pending review, Accepted, or Rejected (view mode only)
Edit button
Switch to edit mode (view mode only)
Copy button
Copy the test case name and ID to the clipboard
Close button
Close the drawer
Details tab:
Prerequisite
Linked prerequisite title, if one exists
Name
Test case name (editable in edit mode)
Description
Detailed description of the test scenario
Test Type
Classification dropdown (Positive, Negative, Edge, Field Validation, End to End, Functional, Boundary Value)
Priority
Priority level with color-coded badge (Critical, High, Medium, Low, or Unassigned)
Variables in use
Variables referenced in test steps, displayed as ${name} badges (view mode)
Steps
Ordered list of test steps with expected results; variable references appear as inline chips
Variables tab:
The Variables tab displays all variables as a key-value table. In view mode, each row shows the variable name and its current value. In edit mode, you can:
Edit variable names and values inline
Click Add variable to create a new row
Delete a variable by clicking its remove button (a confirmation prompt appears if any steps reference the variable)
Validation feedback appears for duplicate names, invalid characters, and empty keys.
Approving or rejecting test cases
From the test case detail drawer, you can:
Click Approve & Move to Repository to accept the test case and add it to your test case repository.
Click Reject to decline the test case.
Click the Edit icon in the header to modify the title, description, test type, priority, variables, or steps before making a decision.
For rejected test cases, click Revert to Review to return the test case to the pending state.
When editing, click Save Changes to keep your modifications or Cancel Changes to discard them. You can also press Enter to save or Escape to cancel. A confirmation dialog appears if you attempt to close the drawer with unsaved changes.
Questionnaire tab
The Questionnaire tab displays the clarification questions that ContextQA's AI generated during requirement analysis, along with any answers you provided.
Each item shows the question text and an answer field. If no questions were generated, an empty state message appears.
AI analysis tab
The AI Analysis tab provides a detailed breakdown of how ContextQA's AI interpreted your requirements document. The tab displays four information cards:
AI understanding
A summary of what the AI understood from your requirements document. This appears as a highlighted section at the top of the tab.
Assumptions made
A numbered list of assumptions the AI made during analysis. Review these to verify the AI correctly interpreted ambiguous or incomplete requirements.
Coverage notes
A summary of which areas the generated test cases cover, with a bullet list of specific coverage points. Use this to verify that all critical requirements have corresponding test cases.
Warnings and gaps
A list of potential issues the AI identified, such as:
Requirements that could not be fully covered
Ambiguous specifications that may need clarification
Areas where additional test cases might be needed
Confidence score
A progress bar showing how confident the AI is in its analysis (0–100%). A higher score indicates the requirements were clear and well-structured. The score includes a descriptive label explaining the confidence level.
Gaps tab
The Gaps tab identifies areas where your requirements may not be fully covered by the generated test cases. Gaps appear as cards in a two-column grid layout.
Gap cards
Each gap card displays:
Title — what the gap is about
Similarity score — a progress bar showing how closely existing test cases match this requirement area (lower scores indicate larger coverage gaps)
Tags — requirement ID, test case priority, test case type, and prerequisite warnings
Why missing — explanation of why this gap exists
View details — opens the gap detail drawer
Gap detail drawer
Click View details on any gap card to open a side panel with:
Similarity score
A ring chart showing the similarity percentage with a descriptive explanation
Summary
Detailed summary of the coverage gap
What's missing
Numbered list of specific items not covered by existing test cases
AI-suggested test cases
Test cases the AI recommends to fill the gap, each with a confidence percentage and status badge
Adding suggested test cases
From the gap detail drawer:
Click Add to Test Cases on an individual suggestion to add it to your test case repository.
Click Add All in the footer to add all pending suggestions at once.
Suggestions that have already been added display an "Already Added" badge with the linked test case ID.
To dismiss a gap you do not need to address, click Close to return to the gap list.
Metadata tab
The Metadata tab displays detailed information about the uploaded file, organized into four sections:
File information
File Type
Format of the uploaded file
File Size
Size of the uploaded file
Page Count
Number of pages in the document
Word Count
Total word count
Version
Document version
Configurations
Test Plan
Associated test plan (if created during import)
Test Suite
Associated test suite (if created during import)
Platform
Target platform (Web or Mobile)
Browser or Mobile Device
Target browser or device (depends on platform)
Timestamps
Created By
Team member who uploaded the file
Created At
Upload date and time
Last Modified
Most recent modification date
Labels
Displays any labels or tags associated with the requirement file. Click +N to expand and view all labels when more than five are assigned.
Related documentation
Creating Test Cases — How to import files and generate test cases
AI Test Generation — All AI-powered test generation methods
Managing Test Suites — Organize test cases into suites
Test Data Management — Variables and data-driven testing
Last updated
Was this helpful?