# What Re:agent knows

> Read and change what Re:agent has learned about each of your apps.

Source: https://rehearsal.dev/docs/reagent/memory

Re:agent keeps notes on each of your apps: what the app is, its features, who uses it, the flows that matter and anything worth knowing before testing it. It reads them every time it works on the app, so a second exploration starts from what the first one learned. You can read the notes and change them by telling Re:agent in your own words.

## Find the notes

Open **Settings** and, under your project, choose **What Re:agent knows**. A project with more than one app has a tab for each at the top. Before the app has been explored, the page offers **Explore Parcel**, and after that **Explore again** stands at the top. Either opens a new chat with **Explore** ready in the message box.

## What the notes hold

The notes are short sentences in five sections, always in this order:

| Section | What goes there |
| --- | --- |
| **What it is** | What the app is for, and how much of it Rehearsal reached when it mapped it. |
| **Features** | What people can do in it, such as saving a card for checkout. |
| **Who uses it** | The kinds of people who use it, such as members and admins. |
| **Flows that matter** | The journeys worth testing, one to a line, such as inviting a teammate. |
| **Things to know** | Anything that changes how to test it, such as a new account confirming its email first. |

A sentence a subagent wrote carries the page it saw it on, which opens that page in a new tab. A flow that one of your saved tests covers is marked **Tested**, which leads to the test, and loses the mark if the test is deleted. The line at the foot of the card says where the notes came from, such as an exploration on a given day and a number of saved tests, and when your own words last changed them.

## Who writes them

- **Subagents** write down what they learn while they explore, each sentence with the page they learned it on.
- **The map** of your app keeps one sentence under **What it is**, such as "The crawl reached 34 pages, signed in as member, and signed out." Each time Rehearsal maps the app again, the new sentence takes the place of the old one.
- **Saved tests** mark the flow they cover as **Tested**.
- **You**, through the box at the foot of the page.

What you write ranks above everything else. A later exploration or a saved test adds to the notes but never removes or rewrites a sentence of yours, which is what the page means by **What you change here stays**.

## When Re:agent reads them

Re:agent reads the notes at the start of every reply in a chat about the app, and every subagent of an exploration reads them before it starts work. When Re:agent opens a browser on an app it has notes about, the row in the chat says **using what it knows**.

Notes can fall behind the app. Re:agent is told that the page in front of it wins, so when the app now works differently from what a note says, it goes by the page.

## Change them

Write in the box at the foot of the page, **What should Re:agent remember or change?**, the way you would tell a colleague, such as "Members can save at most five cards" or "Forget the line about the old checkout". Re:agent answers above the box and changes the notes, and the sentences your words added light up on the card.

To reword a sentence, say what it should say instead, and Re:agent takes the old one out and writes yours in its place. The box changes the notes and nothing else, so to explore or create a test, use a chat in **Re:agent**. An ordinary chat reads the notes but cannot change them; only this page can.

The notes belong to the app, so everyone in the project reads the same ones, while your conversation with Re:agent on this page is yours alone. Changing them takes the same permission as changing the project.

> [!NOTE]
> **Good to know**
>
> Keep passwords and sign-in codes out of the notes. Re:agent signs in with the project's [test accounts](https://rehearsal.dev/docs/reagent/test-accounts.md), which keep each password encrypted and out of the chat.

## Next steps

- [Explore your app](https://rehearsal.dev/docs/reagent/explore.md): Start an exploration that adds to the notes.
- [Questions from Re:agent](https://rehearsal.dev/docs/reagent/questions.md): Answers Re:agent keeps with the project.
- [Test accounts and secrets](https://rehearsal.dev/docs/reagent/test-accounts.md): Give Re:agent the accounts it signs in with.
