←Back/Product/Codex/FigJam
IntermediateProduct

Automate Software Bug Bashing with a Browser Agent

Use a browser agent, such as the one Ezra calls Astra in Codex to systematically test software changes based on a documented test plan. The agent diligently follows instructions to catch edge cases and inconsistencies that a busy human might miss, writing its findings back to a shared document for review.

Illustration of Automate Software Bug Bashing with a Browser Agent

In Codex, I have a little bug bash. I have a threaded conversation that just lives here all the time. And when something new comes up for our team... we have these FigJam files that explain, 'Here's how to bug bash it. Here's the test account to take, here's the path to follow'... I have started basically snagging one account for me and one account for Astra and just having it run through... it will run through all of these scenarios, and it will use the browser, and it's a dream. And then…

Before you start

What you need

  • A FigJam file (or other document) containing a detailed test plan.
  • Access to a browser-based AI agent like Codex.
  • Separate test accounts for the human and the agent.

What you’ll make

A FigJam board populated with comments from the AI agent detailing the bugs and issues it discovered during the test run.

Tools used

  • Codex

    OpenAI's cloud-based AI software engineering agent that can execute code, run tests, and handle complex multi-file tasks autonomously.

    VisitCodex
  • FigJam

    Figma’s collaborative online whiteboard for planning and workshops.

    VisitFigJam

The workflow

Follow the sequence once, then adapt the prompts, checks, and handoffs to your own setup.

5 steps

Step 01

Create an Executable Test Plan

In a FigJam file, document the exact steps for testing a feature. This plan is the primary input for the agent.

Be explicit. Include which test account to use, the URL to start at, the exact sequence of clicks and inputs, and what the expected outcome of each action is. The more detailed the plan, the more effective the agent will be.

Step 02

Initiate a Bug Bash Session

Open a persistent conversation thread in your browser agent (e.g., Codex). This thread will be dedicated to the bug bash.

Example prompt
This is an example prompt: "You are Astra, my QA partner. We are going to bug bash the new seat request modal. Your test account is [test_account_email]. Follow the test plan located in this FigJam file: [link_to_figjam]. Be diligent and execute every scenario."

Assigning the agent a specific persona and test account helps it maintain context throughout the session.

Step 03

Execute the Test Plan

Instruct the agent to begin working through the scenarios in the test plan. The agent will take control of a browser window to perform the actions.

Example prompt
This is an example prompt: "Please begin with scenario 1 in the test plan. Document any deviations from the expected behavior, errors, or visual glitches you encounter. When you are finished with all scenarios, let me know."

The key instruction is for the agent to be more diligent than a human and follow the directions precisely, rather than taking shortcuts.

Step 04

Write Findings to FigJam

Once the agent has completed the test scenarios, instruct it to add its findings as comments on the original FigJam board.

This step centralizes all findings—both human and AI-generated—in one place, making triage easier for the product manager.

Step 05

Triage the Agent's Findings

As the product manager, review the comments left by the agent on the FigJam board. Evaluate the severity of each issue and create tickets for the engineering team as needed.

The human remains the ultimate decision-maker on what constitutes a launch-blocking bug versus a minor nit to be fixed later.

What good looks like

  • The agent successfully navigates the specified user paths in the browser.
  • The agent identifies bugs or inconsistencies, such as edge-case input failures or grammar errors dependent on account data.
  • The agent's findings are written back to the specified FigJam board for human review.

Build your next product with ChatPRD

Turn an idea into a PRD, user stories, and a plan.

Try ChatPRD free

Runbook notes

How to recover when the loop fails and where human judgment helps.

If it goes sideways

The agent's comments on the FigJam board are verbose, poorly formatted, or 'annoying,' making them difficult for the team to parse.
Refine the prompt to instruct the agent on how to format its output. Provide examples of good and bad bug reports in the instructions.
The agent misunderstands the test plan or gets stuck on a step due to ambiguous instructions.
Review and revise the test plan to be more explicit and machine-readable. Break down complex actions into smaller, more direct steps.

Human checkpoints

Let routine work keep moving.

  1. A human must review the agent's findings to triage bugs, assess severity, and decide which issues are launch-blockers.

Start shipping better products.

Join 250,000+ product managers who use ChatPRD to write better docs, align teams faster, and build products users love.

Free to start · 14-day Pro trial · SOC 2 Type II