> ## Documentation Index
> Fetch the complete documentation index at: https://docs.empirical.run/llms.txt
> Use this file to discover all available pages before exploring further.

# App Knowledge

> Document your product to guide test generation agents

App Knowledge is documentation about your product that guides our agents when writing tests. The more context it has, the better the generated tests.

Files are stored as markdown in your `.empiricalrun` directory and can be viewed and edited from the dashboard.

## What to document

| Topic                       | Examples                                           |
| --------------------------- | -------------------------------------------------- |
| User flows                  | Sign up, checkout, onboarding steps                |
| Business rules & edge cases | Discount logic, permission boundaries, rate limits |
| Auth patterns               | Login methods, session handling, protected routes  |
| Domain terminology          | Product-specific terms the agent should understand |

## Adding a file

<Steps>
  <Step title="Navigate to App Knowledge">
    Go to the **App Knowledge** page
  </Step>

  <Step title="Create a new file">
    Click **"Create New File"**
  </Step>

  <Step title="Write documentation">
    Write your documentation in markdown
  </Step>

  <Step title="Save">
    Save — the agent picks it up on the next request
  </Step>
</Steps>