1. Docs
  2. Build tests
  3. Discover
  4. Notes

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.

1 min read Updated CustomersAdmins

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#

TypeExample noteWeightScope
EnvironmentTEST resets its database every night at 02:00; data created before that is gone.MediumWhole project
Identity & rolesOnly users with the Approver role see the Approve button on refunds.CriticalPage refunds
Data preconditionsCheckout needs a customer with a saved address and a card ending 4242.CriticalPage checkout
Business rulesOrders over €10,000 need a second approver.CriticalModule Orders
UI behaviourSearch results load after 2 seconds of no typing; wait before checking them.LowPage 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 or a page). 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. Notes written by the AI carry an AI suggestion chip until you review them.

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).
  • 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.

Didn’t find your answer?Write to support with your project name and what you see on screen.

info@smartestqa.ai