---
title: "AI assessment"
section: "Analyze"
description: "How SmartestQA Assessment (AI) reviews a main requirement with its subs: running it, what it checks, the Quality Score and how to improve it."
url: https://docs.smartestqa.ai/en/analyze-assessment.html
audience: [customer, admin]
updated: 2026-11-08
keywords: "ai assessment requirement quality score excellent good fair needs improvement suggestions missing areas sub requirements average coverage score analyze"
---
# Analyze: AI assessment

Assessment (AI) reads a main requirement together with all its sub-requirements and tells you how complete and testable they are. It scores the main and each sub, and lists what is missing.

## In short

**On this page you can**

- Score a main requirement and all its subs in one AI review.
- See the areas no sub-requirement covers yet, as suggestions.
- Read each sub’s own score, summary and suggestions.
- Track progress with Last assessed and a fresh run after each edit.

**How to use it**

1. Select the main requirement and save any changes.
2. Open Assessment (AI) on the right and click Analyze .
3. Read Quality Score , Summary and Suggestions .
4. Turn each missing area into a new sub-requirement, save, and run it again.

## Run an assessment

1. **Select the main requirement**

   Click it in the [tree](https://docs.smartestqa.ai/en/analyze-folders.html#tree). Assessment works on main requirements only; a sub-requirement is assessed together with its main.
2. **Save first**

   With unsaved changes, **Analyze** is greyed out: “Please save your changes before analyzing with AI”. Click **Save**.
3. **Open Assessment (AI)**

   On the right panel, open the **Assessment (AI)** tab (on a narrow screen, the rail **AI Assessment**). The header shows “Main Requirement: *name* (ID: *n*)”.
4. **Click Analyze**

   The button reads “Analyzing...” while the AI works.

   “Assessment completed successfully” and the result below. It is saved with the requirement and shown again next time.

Needs [**Enable AI**](https://docs.smartestqa.ai/en/project-settings-ai.html#enable-ai) in [Project Panel › AI Options](https://docs.smartestqa.ai/en/project-settings-ai.html) and a [working AI key](https://docs.smartestqa.ai/en/project-settings-ai.html#ai-account). A main requirement with no sub-requirements is assessed on its own.

## What the AI checks

One request goes to the project’s [AI model](https://docs.smartestqa.ai/en/project-settings-ai.html#ai-account) with the main requirement and every sub-requirement. The AI answers two questions.

| Scored | Questions the AI is asked |
| --- | --- |
| The main requirement | Is every aspect of the main covered by at least one sub? Is there enough detail across the subs? Are there gaps, missing flows or unhandled edge cases? Is the main itself clear? |
| Each sub-requirement | Clarity and specificity, testability, completeness, acceptance criteria, edge cases and error handling, security and performance, and fit with the main requirement. |

**What it receives:** the names and descriptions of the main and its subs, and each sub’s severity. It does not see your [App Map](https://docs.smartestqa.ai/en/discover-app-map.html), [Notes](https://docs.smartestqa.ai/en/discover-notes.html), [documents](https://docs.smartestqa.ai/en/analyze-folders.html#documents) or [test cases](https://docs.smartestqa.ai/en/analyze-test-cases.html), so it judges the text, not whether tests exist.

> **AI: A judgement, not a formula**
>
> The score is the AI model’s verdict. Running it again can give a slightly different number even when nothing changed. Compare trends, not single points.

## Read the result

| Part | What it tells you |
| --- | --- |
| [**Quality Score**](https://docs.smartestqa.ai/en/analyze-numbers.html#quality-score) | The AI’s score for the main requirement and how well its subs cover it, 0–100%, with a label: Excellent, Good, Fair or Needs Improvement. See [how it is calculated](https://docs.smartestqa.ai/en/analyze-numbers.html#quality-score). |
| **Last assessed** | When it last ran. |
| **Summary** | One or two sentences on the overall state. If the AI skipped some subs, it ends with “Note: *n* sub(s) could not be scored by the LLM.” |
| **Suggestions** | For a main requirement: the **missing areas**, aspects no sub-requirement addresses yet. Each one is a candidate for a new sub. |
| [**Score Breakdown**](https://docs.smartestqa.ai/en/analyze-numbers.html#score-breakdown) | Two bars and “*n*/*m* sub-requirements assessed”. If some subs were not scored, they are listed under “*n* sub-requirement(s) not yet assessed:”. See [Score Breakdown](https://docs.smartestqa.ai/en/analyze-numbers.html#score-breakdown). |

### Results for each sub-requirement

The same run stores a score, a summary and 3 to 5 suggestions on every sub-requirement. Select a sub in [**Sub Requirements**](https://docs.smartestqa.ai/en/analyze-requirements.html#sub-requirements) and open **Assessment (AI)** to read them. **Analyze** stays greyed out there: “Sub-requirements are analyzed together with the main requirement. Please select the main requirement and click Analyze.”

## Raise the score

1. **Add the missing areas**

   Turn each suggestion of the main requirement into a [sub-requirement](https://docs.smartestqa.ai/en/analyze-requirements.html#sub-requirements) with **Add**.
2. **Fix the weakest subs**

   Open the subs with the lowest scores and apply their suggestions: a clear condition, a measurable result, the error case.
3. **Sharpen the main description**

   State the goal, who does it, and what is out of scope.
4. **Save and analyze again**

   Click **Save**, then **Analyze**.

Example · from Fair to Good

```text
Before   Main "Pay with a saved card", 2 subs                Quality Score 48%  Fair
         Suggestions: expired card · card removed by the bank · 3-D Secure step
After    + 3 subs for those areas, sharper success criteria    Quality Score 76%  Good
```

> **Tip: Assessment and coverage are different things**
>
> A high Quality Score means the requirement is well written and complete. It does not mean it is tested. Tested is shown by linked test cases and [Test Health](https://docs.smartestqa.ai/en/insight-test-health.html#pillars); see [What counts as covered](https://docs.smartestqa.ai/en/analyze-test-cases.html#coverage).

## If something goes wrong

- [Analyze is greyed out](https://docs.smartestqa.ai/en/analyze-troubleshooting.html#fix-analyze-greyed)
- [“AI Assessment failed: …”](https://docs.smartestqa.ai/en/analyze-troubleshooting.html#fix-assessment-failed)
- [Some sub-requirements were not assessed](https://docs.smartestqa.ai/en/analyze-troubleshooting.html#fix-unassessed-subs)
- [The breakdown says 50% weight but the numbers don’t add up](https://docs.smartestqa.ai/en/analyze-troubleshooting.html#fix-score-weight)
