---
title: "Write requirements"
section: "Analyze"
description: "Write requirements in SmartestQA Analyze: create a main requirement, add sub-requirements by hand or with AI, set the fields, save and comment."
url: https://docs.smartestqa.ai/en/analyze-requirements.html
audience: [customer, admin]
updated: 2026-11-08
keywords: "create requirement new requirement main requirement sub requirement generate sub requirements status severity assignee start date end date tags comments mention save unsaved changes"
---
# Analyze: Write requirements

A main requirement describes one feature or user flow; its sub-requirements are the conditions a test can prove. This page covers writing both by hand, with AI help for the sub-requirements.

## In short

**On this page you can**

- Create a main requirement in a folder with New Requirement .
- Add sub-requirements by hand or with Generate (AI, 3–5 proposals).
- Set Status, Severity, Assignee and dates for the main and for each sub.
- Tag requirements and discuss them in Comments with @mentions.
- Save everything in one go and avoid losing unsaved edits.

**How to use it**

1. Select a module folder and click New Requirement .
2. Type Name and Description , then click Save .
3. Under Sub Requirements , click Add or Generate .
4. Fill each sub’s Status and Severity in Detail .
5. Click Save again: subs, links and fields are stored together.

## Create a main requirement

1. **Select the folder**

   Click the module folder (or a sub folder in it) in the [tree](https://docs.smartestqa.ai/en/analyze-folders.html#tree). Requirements cannot go into [Documents](https://docs.smartestqa.ai/en/analyze-folders.html#documents-rules).
2. **Click New Requirement**

   An empty main requirement is created there and selected: “Requirement added successfully”. It already counts toward your licence’s [requirement limit](https://docs.smartestqa.ai/en/company-settings-billing.html).
3. **Write Name and Description**

   Name the flow, verb first: `Pay with a saved card`. In **Description** say who does what and why, in two or three sentences. Both are required.
4. **Add tags (optional)**

   Click the tag field to pick or create tags. Two tags are shown, the rest as **+*n***. Tags feed the [tree filter](https://docs.smartestqa.ai/en/analyze-folders.html#filter).
5. **Save**

   Click **Save**.

   “Requirement saved successfully”. The tree shows the new name.

![A main requirement with its sub-requirements.](https://docs.smartestqa.ai/media/shots/ANA-SHOT-03.png)

## Fields

The centre holds Name, Description and Tags. The right panel’s **Detail** tab holds the rest, for the main requirement or for the sub-requirement you selected.

| Field | Values | Notes |
| --- | --- | --- |
| Name | Text, required | Up to 255 characters. |
| Description | Text, required | The AI features read it: write the goal and the rules, not just a title. |
| Tags | Project tags | Stored on the main requirement. |
| **Status** | New, Assigned, Implemented, Closed | Default New. You set it; nothing changes it automatically. |
| **Severity** | Low, Medium, High, Critical | Default Medium. High and Critical sub-requirements count as **risky** in [InSight › Test Health](https://docs.smartestqa.ai/en/insight-test-health.html#pillars). |
| **Assignee** | A [user of the project](https://docs.smartestqa.ai/en/company-settings-users.html#project-access), or **Unassigned** | The assignee of a main requirement is notified: “A requirement has been assigned to you”. |
| **Start Date**, **End Date** | Dates | Start Date cannot be in the future and cannot be after End Date. |
| **Created by**, **Updated Date**, **Updated by** | Read-only | Filled by SmartestQA. |

## Add sub-requirements

A sub-requirement is one condition and its expected result. Test cases link to sub-requirements, not to the main, so a main requirement without subs cannot be traced to tests.

1. **Open the dialog**

   Under **Sub Requirements**, click **Add**. The dialog **Add Sub Requirement** opens.
2. **Fill it in**

   **Name** and **Description** are required; **Save** stays disabled until both are filled. Status, Severity, Assignee and dates are optional.
3. **Save the dialog**

   The row appears with the tag **new** and the message “sub requirement added”. **It is not stored yet.**
4. **Save the main requirement**

   Click **Save** in the centre. All new, changed and removed subs are stored in one go.

- **Reorder** by dragging rows. The order is kept and [pipelines run the subs](https://docs.smartestqa.ai/en/analyze-test-cases.html#pipelines) in this order.
- **Row actions**: **Automate** (AI test cases, see [Generate test cases](https://docs.smartestqa.ai/en/analyze-test-cases.html#ai-automate); available once the sub is saved), **Edit**, **Delete**.
- **Select a row** to show that sub’s Detail and test cases on the right. **Main Requirement** above the fields takes you back to the main view.

### Generate sub-requirements with AI

1. **Save the main requirement first**

   **Generate** is disabled on an unsaved main (“Please save the main requirement first”), and the AI needs a Description (“Requirement description is required”).
2. **Click Generate, then Analyze**

   The dialog **Generate Sub Requirements** shows the main requirement. Click **Analyze**. The AI reads the Name and Description and proposes 3–5 sub-requirements.

   “*n* sub requirements generated”, all ticked.
3. **Pick and add**

   Untick the ones you do not want, then click **Add**. They join the list as **new**.
4. **Review and save**

   Edit names and descriptions where needed, set Severity, and click **Save**.

> **AI: What the AI uses here**
>
> Only the main requirement’s Name and Description. For proposals that know your pages and rules, use the [AI wizard](https://docs.smartestqa.ai/en/analyze-import.html) with a [**Target scope**](https://docs.smartestqa.ai/en/analyze-import.html#scope) instead.

## What a good requirement looks like

Write a main requirement as a user flow, and each sub-requirement as one condition with one observable result. That is also how SmartestQA’s [AI tools](https://docs.smartestqa.ai/en/mcp.html) are told to write them.

Example · main requirement with sub-requirements

```text
Main  Reset a forgotten password
      A signed-out user can set a new password through an emailed link.

Sub   A registered email receives a reset link within one minute        Severity High
Sub   An unknown email shows the same confirmation (no account leak)     Severity Critical
Sub   A link older than 24 hours shows "Link expired"                    Severity Medium
Sub   The new password must meet the password rules; errors are shown    Severity Medium
Sub   After the reset, the old password no longer signs in               Severity High
```

#### Do

- One main requirement per user flow, with about 3 to 8 subs.
- Give each sub a result you can see or check.
- Add the error and edge cases as their own subs.
- Use the words of the app and of your [Notes](https://docs.smartestqa.ai/en/discover-notes.html).

#### Don’t

- Copy document headings as requirements.
- Put two conditions in one sub (“…and also…”).
- Write subs that only repeat the main’s name.
- Leave Severity at Medium for everything.

## Saving and leaving

- **Save** stores the main requirement, all its sub-requirements and their test case links together. Until then, every change is only on your screen.
- If you leave with unsaved changes, SmartestQA asks “Are you sure to exit without saving?” with **Exit without saving**, **Cancel** and **Save and Exit**.
- If the save changed which test cases the requirement has, and the requirement is in a pipeline, the dialog **Update Scheduler Parameters** offers to sync those pipelines. See [How links reach pipelines](https://docs.smartestqa.ai/en/analyze-test-cases.html#pipelines).

> **Important: A removed sub-requirement is deleted for good**
>
> Deleting a sub-requirement in the list and clicking Save removes it and its test case links permanently. It does not go to the [Archive](https://docs.smartestqa.ai/en/analyze-folders.html#archive). The test cases stay in [Automate](https://docs.smartestqa.ai/en/automate-test-cases.html).

## Comments

Open **Comments** at the bottom of the right panel. Comments belong to the main requirement.

- Write in **Write a comment...** and click **Send**. Bold, italic, lists and quotes are available.
- Type `@` to mention a team member (“Type @ to mention a team member”).
- You can edit and delete only your own comments.

Video: [Write a requirement and its sub-requirements](https://docs.smartestqa.ai/media/videos/ANA-02.mp4) (2:30)

New Requirement, Add and Generate for subs, Detail fields, Save and comments.

Video transcript: New Requirement adds an empty requirement to the tree and opens it. Name it after what the user can do. In Description, say who it is for and what they get. Add opens a sub-requirement: one rule, written so that it can be tested. Add one for each rule, including what must not happen. Generate proposes sub-requirements with AI from the name and description. Save. The requirement takes its name in the tree, with its sub-requirements listed.

## If something goes wrong

- [“Please fill Name and Description”](https://docs.smartestqa.ai/en/analyze-troubleshooting.html#fix-name-description)
- [A date message blocks saving](https://docs.smartestqa.ai/en/analyze-troubleshooting.html#fix-dates)
- [Generate is greyed out](https://docs.smartestqa.ai/en/analyze-troubleshooting.html#fix-save-main-first)
- [“No sub requirements generated”](https://docs.smartestqa.ai/en/analyze-troubleshooting.html#fix-generate-subs)
- [“… could not be updated, please try again later”](https://docs.smartestqa.ai/en/analyze-troubleshooting.html#fix-update-failed)
- [A sub-requirement disappeared after saving](https://docs.smartestqa.ai/en/analyze-troubleshooting.html#fix-sub-gone)
