Browser Evidence and Its Limits
Module 4 · Discernment

Browser Evidence and Its Limits

Antigravity agents can open a browser, click through your app, and record what they saw. Learn what screenshots and recordings prove, what they can't, and how to brief browser checks that test the things that matter.

The Agent Checked Its Own Work, in a Browser

One of Antigravity’s standout features is that agents can use a browser, a Chrome-based browser they control, to load the app they’re building, click through it, and capture screenshots and browser recordings as artifacts. Instead of “I think the form works now,” you get a video of the agent filling in the form and the success message appearing.

That’s real evidence, much better than an unchecked claim. But evidence of what, exactly?


What a Recording Shows, and What It Doesn’t

A recording can showA recording can’t show
The happy path worked once, with this data, in this browserThat other paths, inputs, or browsers work
The UI looked a certain way at a certain sizeThat it’s accessible to keyboard and screen-reader users
A success message appearedThat the data was actually saved correctly on the server
No visible errors during that runThat no errors were logged, or that it’s secure
How long it took on the agent’s machineHow it performs under real load
What’s on screenBrowser state and client codeAPI and server logicDatabaseLogs, emails, other users’ viewsThe recordingsees thisNeeds other checks:tests, DB queries,logs, your own useA smooth recording proves the top layer worked once.

The agent chose what to test. Agents tend to test the path they just built, with the data they expect, and stop when it works. That’s exactly the path least likely to be broken.

⚠️ Common Pitfall: The Happy-Path Recording

Common mistake: watching a smooth recording of a sign-up flow and concluding the feature is done.

It signed up test@example.com with a valid password once. What about a duplicate email? A 200-character name? An expired session halfway through? Pressing the back button? A phone-width screen? The recording proves one run, not the feature.


Briefing Browser Checks That Matter

Treat browser verification as part of description: tell the agent what to verify, not just to verify.

In the walkthrough, include browser recordings of:

  1. The happy path: a new user signs up and lands on the dashboard.
  2. A duplicate email: the user sees the “already registered” message, and no second account is created.
  3. A password that’s too short: the inline error appears and the form keeps the other fields filled in.
  4. The sign-up page at 375px width. After the browser checks, query the users table and show the rows for these test accounts.

The last line matters. It checks the server side, which the screenshots can’t see.


Do Your Own Spot Check

For anything user-facing, click through it yourself at least once. You’ll notice things no agent was asked to look for: a confusing label, a slow transition, a button that’s hard to reach on a phone. The recordings tell you where to start. Your own use tells you whether it’s good.


Browser Safety, Briefly

A browser-using agent also reads whatever pages it visits. If an agent browses beyond your local app, those pages can contain text designed to manipulate it (module 5). Antigravity provides browser allowlists and denylists and the option of a separate Chrome profile. Use them to keep agent browsing to your local dev server and the documentation sites you trust, and keep it away from your logged-in personal accounts.

🧪 Try It: Beyond the Happy Path
  1. Pick a user-facing flow in a project: sign-up, checkout, search, or a settings form.
  2. Write a browser-verification brief with the happy path plus at least three edge cases, one narrow screen size, and one server-side check.
  3. Have an agent implement or test the flow with that brief.
  4. Watch the recordings. For each one, write what it proves and what it doesn’t.
  5. Click through the flow yourself and note one thing none of the recordings showed.
🧠 Knowledge Check

1. An agent's recording shows a checkout completing successfully. What does it NOT prove?

2. What's the best way to get useful browser evidence from an agent?

3. Why restrict which sites a browser-using agent can visit?


Up Next

Module 5 is Diligence, starting with what Antigravity’s real security incidents teach about running agents safely.