# Requirements Coverage Gaps

{% hint style="info" %}
**Who is this for?** QA engineers, testers, and QA managers who upload requirement documents and want to identify which requirements lack adequate test coverage.
{% endhint %}

When you upload a requirements document, ContextQA's AI engine analyzes it against your existing test cases and identifies coverage gaps — requirements that are not yet tested or only partially covered. The **Gaps** tab shows these gaps with similarity scores, and you can accept AI-suggested test cases to close them.

***

## Prerequisites

* A ContextQA workspace with AI features enabled.
* At least one requirement document uploaded through the **Import Requirement** option (see [Creating Test Cases](/web-testing/creating-test-cases.md)).
* The uploaded file must have finished processing (status: **Completed** or **Pending Action**).

***

## Opening the requirements library

1. In the left navigation, go to **Test Development**.
2. Select **Imported Files**.
3. The Imported Files list displays all uploaded requirement documents with their status, test case count, and creation details.
4. Click a file name to open the file details view.

{% hint style="info" %}
**Filtering by test plan:** Use the test plan filter dropdown above the list to narrow results. Type to search across your test plans — the filter supports server-side search with pagination.
{% endhint %}

***

## Understanding file statuses

| Status             | Meaning                                                                                                        |
| ------------------ | -------------------------------------------------------------------------------------------------------------- |
| **Completed**      | Processing finished. Test cases and gap analysis are available.                                                |
| **Pending Action** | The AI needs clarification before generating test cases. Answer the questions or skip to generate immediately. |
| **Processing**     | The file is still being analyzed. Refresh the page to check progress.                                          |
| **Failed**         | An error occurred during processing. Check the error details and re-upload if needed.                          |

***

## Answering AI clarification questions

When a file has **Pending Action** status, ContextQA's AI has questions about your requirements to improve test generation accuracy.

1. Click the file name. The **Help AI Understand Your Requirements** dialog opens.
2. Review each question. The AI provides context explaining why it needs this information.
3. Enter your answers in the text fields.
4. Click **Submit** to send your answers and start test generation.

To skip the questions, click **Skip & Generate Test Cases**. The AI generates test cases using its best interpretation of the requirements.

{% hint style="warning" %}
**Answering questions improves accuracy.** Providing answers helps the AI generate more relevant test cases and more accurate gap analysis. Skip only if the requirements are straightforward.
{% endhint %}

***

## Reviewing the gaps tab

Once a file finishes processing, the file details view shows multiple tabs. Select the **Gaps** tab to see AI-identified coverage gaps.

Each gap card displays:

* **Requirement identifier** — the requirement ID (e.g., REQ-001) and type tag.
* **Priority** — the assessed priority level of the gap.
* **Similarity score** — a percentage indicating how closely the requirement matches existing test cases. A lower score means less coverage.
* **Summary** — a brief description of what the gap covers and why it was flagged.
* **Missing prerequisites** — any prerequisites identified as missing from current test coverage.

### What the similarity score means

| Score range | Coverage level    | Action needed                                 |
| ----------- | ----------------- | --------------------------------------------- |
| 80–100%     | Well covered      | Review for edge cases only                    |
| 50–79%      | Partially covered | Review suggested test cases                   |
| 0–49%       | Poorly covered    | Strongly consider adding suggested test cases |

{% hint style="info" %}
**No gaps found?** If the Gaps tab shows "No gaps found — All requirements are well covered," your existing test cases already provide adequate coverage for this requirements document.
{% endhint %}

***

## Inspecting gap details

1. On a gap card, click **View details**.
2. The gap detail drawer slides open from the right side of the screen.

The drawer displays:

* **Similarity score ring** — a visual indicator showing the coverage percentage with color coding (green for high, amber for medium, red for low).
* **Summary** — a detailed explanation of the coverage gap.
* **What's missing** — a list of specific items not covered by existing test cases.
* **AI-suggested test cases** — test cases the AI recommends creating to close the gap. Each suggestion includes a confidence badge indicating how well it addresses the gap.

Press **Esc** or click outside the drawer to close it.

***

## Accepting AI-suggested test cases

### Accept a single suggestion

1. Open the gap detail drawer for a gap.
2. Review the suggested test case details (title, steps, expected results).
3. Click **Add to Test Cases** on the suggestion you want to accept.
4. The test case is created and added to your test suite.

### Accept all suggestions for a gap

1. In the gap detail drawer, click **Add All** to accept every pending suggestion at once.
2. All suggested test cases are created and added to your test suite.

### Accept all suggestions from the gaps tab

1. On the Gaps tab, click **Add All Test Cases** to bulk-accept all AI suggestions across every gap.
2. All pending suggestions for the entire requirements document are created as test cases.

{% hint style="warning" %}
**Review before bulk accepting.** While the AI generates relevant suggestions, review the gap details and similarity scores before accepting all suggestions. Some may need manual refinement after creation.
{% endhint %}

### Dismissing a gap

If a gap is not relevant, click **Dismiss** in the gap detail drawer. The gap is removed from the active list.

***

## Viewing generated test cases

After accepting suggestions or once processing is complete, view the generated test cases:

1. In the file details view, select the **Test Cases** tab.
2. Test cases are grouped into two sections:
   * **Newly Created Test Cases** — labeled "New," these are test cases generated from your requirements.
   * **Existing Test Cases** — labeled "Duplicate," these match tests already in your repository.
3. Click a test case ID to open it in the test steps editor.

***

## Tips and best practices

* **Upload focused requirements documents.** Smaller, well-scoped documents produce more accurate gap analysis than large, broad documents.
* **Answer clarification questions.** Providing context improves both test generation and gap detection accuracy.
* **Review low-similarity gaps first.** Gaps with scores below 50% represent the largest coverage risks and should be addressed first.
* **Refine accepted test cases.** AI-generated test cases are a starting point. After accepting, review and adjust steps, test data, and assertions as needed.
* **Re-upload after major changes.** If your requirements change significantly, upload the updated document to get fresh gap analysis.

***

## Related pages

* [AI Test Generation](/ai-features/ai-test-generation.md)
* [Creating Test Cases](/web-testing/creating-test-cases.md)
* [Knowledge Base](/ai-features/knowledge-base.md)
* [Analytics Dashboard](/reporting/analytics-dashboard.md)

{% hint style="info" %}
**70% less human effort with AI test generation and self-healing.** [**Book a Demo →**](https://contextqa.com/book-a-demo/) — See AI generate, execute, and maintain tests for your application.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://learning.contextqa.com/ai-features/requirements-coverage-gaps.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.