---
title: "Notes"
section: "Discover"
description: "SmartestQA Notes: write the business rules, roles, data preconditions and environment facts the AI cannot see, set weight and scope, and know which notes reach each AI request."
url: https://docs.smartestqa.ai/en/discover-notes.html
audience: [customer, admin]
updated: 2026-11-07
keywords: "notes business rules identity roles data preconditions environment ui behaviour weight critical scope ai prompt"
---
# Discover: Notes

Notes are facts about the application that no scan can find: entry points, role rules, data preconditions, business constraints. Every active note is fed to AI generation.

## In short

**On this page you can**

- Write the facts no scan can find: roles, data preconditions, business rules.
- Pick one of five note types, each with an example.
- Set each note’s weight (Critical, Medium, Low) and its scope.
- Switch a note off to keep it without sending it to the AI.
- Check which notes reach the AI, within the 6,000-character cap.

**How to use it**

1. Open the Notes tab in Discover.
2. Choose the Type , the Weight and optionally a Scope : project, module or page.
3. Write one rule per note and press Enter.
4. Review notes with the AI suggestion chip; click a note’s text to edit it.
5. When unsure, switch On off instead of deleting: delete does not ask.

## Note types, with examples

| Type | Example note | Weight | Scope |
| --- | --- | --- | --- |
| Environment | TEST resets its database every night at 02:00; data created before that is gone. | Medium | Whole project |
| Identity & roles | Only users with the Approver role see the Approve button on refunds. | Critical | Page `refunds` |
| Data preconditions | Checkout needs a customer with a saved address and a card ending 4242. | Critical | Page `checkout` |
| Business rules | Orders over €10,000 need a second approver. | Critical | [Module](https://docs.smartestqa.ai/en/discover-app-map.html#modules) **Orders** |
| UI behaviour | Search results load after 2 seconds of no typing; wait before checking them. | Low | Page `orders` |

## Add and maintain notes

1. **Add a note**

   Choose the **Type**, the **Weight** (Critical, Medium or Low) and optionally a **Scope** (whole project, [a module](https://docs.smartestqa.ai/en/discover-app-map.html#modules) or [a page](https://docs.smartestqa.ai/en/discover-app-map.html#page-information)). Write the note and press `Enter`.
2. **Keep it current**

   Click a note’s text to edit it. Switch **On** off to keep a note without [sending it to the AI](https://docs.smartestqa.ai/en/project-settings-ai.html#data). Notes written by the AI carry an **AI suggestion** chip until you review them.

> **Important: Deleting a note does not ask for confirmation**
>
> If you are not sure, switch it off instead of deleting it.

## Which notes reach the AI

- Only notes that are **On**.
- Whole-project notes: always.
- Module notes: when any page of that module is part of the request.
- Page notes: when that page is part of the request.
- A scope that is neither a module nor a page assigned to a module counts as a tag and is always sent. This happens after renaming a page (see [rename](https://docs.smartestqa.ai/en/discover-actions.html#rename)).
- The notes block is capped at 6,000 characters. Critical notes go first and are marked `[CRITICAL]`; if notes are dropped for space, the prompt says so.
