Skip to main content
Experience faster, smarter testing with BrowserStack AI Agents. See what your workflow’s been missing. Explore now!
No Result Found
Get your setup working faster. Join our Discord for optimisation tips from elite testers. Join our DiscordJoin our Discord

Test Case Maintenance Agent

Keep your test repository aligned with changing requirements using AI that updates existing test cases and fills coverage gaps.

The Test Case Maintenance Agent updates the test cases you already have. You share your latest requirements. It reads them, scans every test case in your project, and finds the ones that no longer match your new spec. Then it drafts the updates and fills the coverage gaps. You review every edit before it lands.

Agentic capabilities

  • Requirement-aware updates: The agent compares your new specs against the repository and revises the tests that drifted.
  • Coverage-gap detection: The agent spots requirements that have no test and drafts new cases to cover them.
  • Reasoned suggestions: Each change arrives with a plain-language reason and a side-by-side comparison.
  • Iterative refinement: You steer the output with follow-up prompts, without starting over.
  • Background runs: Generation runs in the background and stays tied to your session, so you can keep working in parallel.
  • Test case maintenance using BrowserStack AI is only supported in Team Ultimate plans.
  • BrowserStack does not train its AI models on the data you provide.

The problem it solves

Test cases drift the moment a requirement changes. The repository keeps describing the old behavior while the product moves on. Someone has to find every affected test, rewrite it, and add coverage for the parts of the flow that are now missing. That work is slow. Teams under deadline pressure often skip it.

Stale test cases cause real damage:

  • Tests fail for the wrong reason, because they assert behavior the product no longer has.
  • Real regressions hide inside the noise of those false failures.
  • New requirements ship with no test coverage at all.
  • Testers waste review cycles reconciling old tests against the current spec.

The Test Case Maintenance Agent closes this gap. When your requirements change, it compares them against the test cases already sitting in your project. It then updates whatever no longer matches the new spec. New coverage gaps get filled too. But you review every suggestion before a single test changes.

The maintenance workflow

You run the agent on demand, whenever your requirements change. You share the latest spec, scope the folders it can touch, and start the run. The agent then follows four steps.

  1. Share your latest requirements: Upload a requirement file, such as a PDF or DOCX, or link a Jira issue, Figma frame, or Confluence page. You can also paste requirements or issue links directly.
  2. The agent scans your repository: It compares your new requirements against your current test cases to find which test cases no longer match.
  3. The agent suggests updates and fills gaps: It flags the existing tests to update. It also drafts the new tests you are missing.
  4. You accept the changes: Accepted updates apply to your repository automatically. Nothing changes until you accept it.

You stay in control of scope. The agent updates only the test cases inside the folders you select. It changes nothing until you accept it. Your requirements are never used to train BrowserStack AI models.

The agent suggests updates for system fields only. It does not support custom fields.

Prerequisites

Make sure you have:

  • A project on the Team Ultimate plan.
  • A set of existing test cases for the agent to update.
  • Your latest requirements, ready as a file or as a link from any supported source.

Requirements you can share

The agent works from the requirements you give it. Share one source or several. Combine files with links when a change spans more than one place.

Source What you share
Requirement file A document such as a PDF, DOCX, or image that captures the change.
Jira A link to the Jira issue that holds the updated acceptance criteria.
Azure DevOps A link to the Azure work item that tracks the change.
Linear A link to the Linear issue that tracks the change.
Figma A link to the Figma frame that shows the new design.
Confluence A link to the Confluence page that documents the updated spec.
SharePoint A requirement file stored in your SharePoint account.
OneDrive A requirement file stored in your OneDrive account.
Free text Requirements or issue links you paste into the prompt box.

When you link a tool, the agent opens a short dialog so you can pick the exact item. A tool you have not connected yet shows a connect screen first. Connect it, then pick the item you need. Expand a source for the steps.

Link a Jira issue
  • Click Add Requirements and select Jira.
  • Select your Host, then the Project that holds the issue.
  • Select one or more Issues.
  • Click Link to pull the context into the run.
Link an Azure work item
  • Click Add Requirements and select Azure.
  • Select your Organization, then the Project.
  • Select one or more Work Items.
  • Click Link to pull the context into the run.
Link a Confluence page
  • Click Add Requirements and select Confluence.
  • Select your Host, then the Space.
  • Select the Page that documents the change.
  • Click Link to pull the content into the run.
Link a Figma design
  • Click Add Requirements and select Figma.
  • Enter the Figma link, then click Import.
  • Select the frames you want, then click Save Selection.

File and attachment limits

The maintenance agent reads the same inputs as the rest of BrowserStack’s AI test case generation, so the same limits apply.

Each file you upload must stay within these limits:

File category Supported formats Maximum size Other limits
Documents DOC, DOCX, PDF, RTF 25 MB 25 pages
Presentations PPTX 10 MB 25 slides
Images PNG, JPG, JPEG 5 MB N/A
Data and text CSV, JSON, TXT, XLSX 500 KB N/A

Each generation also caps how many items you can attach from a linked tool:

Source Limit per generation
Jira or Azure DevOps 1 ticket per session. Once a ticket is in the run, you cannot add another in later generations.
Confluence 5 documents per generation.
Figma 1 Figma link, up to 10 frames per generation.
Files 10 files per generation, with one upload per tool.

If a file is larger than its limit, the upload fails. Split or compress it, then try again.

Run the maintenance agent

The whole run happens inside the Generate test cases with AI panel: share the changed spec, turn on maintenance mode, generate, then review and accept. You can refine the suggestions as many times as you need before you accept them.

Flow of a maintenance run from sharing requirements through accept, with an optional refine loop on the review step

Share your requirements

To give the agent the spec that changed, follow these steps:

  1. Open your project and go to Test Cases.
  2. Click Work with AI to open the Generate test cases with AI panel.

    Work with AI button on the Test Cases page, next to Create Test Case

  3. Click Add Requirements, then select your source.

    Add Requirements menu listing Figma, Azure DevOps, Jira, Linear, Confluence, SharePoint, OneDrive, and Upload File

  4. Optional: Add more sources when the change spans several places.
  5. Optional: Paste requirements or issue links into the prompt box.

    Panel with an attached requirement file, a pasted spec, and the Data not used for AI Training badge

For every source type, see Requirements you can share.

Turn on maintenance mode

To scope the run to the tests you want revised, follow these steps:

  1. Click Settings.
  2. Under Generation modes, turn on Update test cases so the agent revises existing tests.
  3. Click Target Folders, which is set to All Folders by default.
  4. In the Choose folders dialog, select the folders the change affects.
  5. Click Update.

    Choose folders dialog beside the Settings panel, with Update test cases on and Target Folders set to All Folders

Tune the output (optional)

Still in Settings, shape how the agent writes each test case:

  1. Set Template, Type, Priority, and Language.
  2. Under Context, select the Additional context sources the agent reads.
  3. Optional: Turn on Shared Steps to reuse shared steps in the tests it writes.

    Output settings panel showing Template, Type, Priority, Language, Additional context, and the three Generation modes toggles

Include datasets stays unavailable while Update test cases is on, because the two generation modes cannot run together.

Setting Options Controls
Template Test cases (Text), Test cases (Steps), Test cases (BDD) The format of each test case: a plain checklist, detailed steps with expected results, or Gherkin (Given/When/Then) scenarios for automation.
Type Functional, UI/UX, Security, Performance, Compatibility, Accessibility The categories of coverage the agent weighs when it updates and writes tests.
Priority Critical, High, Medium, Low The priority levels the agent can assign to the tests it updates or adds.
Language English, and other supported languages The language the agent writes test cases in.
Additional context Azure DevOps, Jira, Linear, Confluence, Folders Extra sources the agent reads for context while it works, including the existing folders in your project.

Generate

To start the run and follow its progress, follow these steps:

  1. Click Generate Test Cases.
  2. Optional: Expand Thoughts to watch which test cases the agent reads.

    Agent run in progress, scanning the repository and summarizing the core feature requirements it found

The agent analyzes your files, scans the repository, and consolidates the requirements before it drafts the changes. The run stays tied to your browser session, so you can close the panel and keep working. It notifies you when the results are ready. The run stops only if you refresh the page or log out.

Review the suggestions

The agent groups its suggestions by scenario. A summary line reports the totals. For example: 4 test cases for update, 7 test cases newly generated across 6 scenarios. Generated tests carry a New badge, and each scenario group has an AI Reasoning note that explains the change.

Suggested changes grouped by scenario, each with an AI Reasoning note and New badges on generated tests

Work through the suggestions with these controls:

  • Select: Check a test case or a scenario group. The header checkbox selects everything.
  • Accept: Apply the change. The agent updates an existing test in place, or adds a new one to your selected folder.
  • Reject: Discard the suggestion. The matching test case stays exactly as it was.

To inspect one change in detail, follow these steps:

  1. Click the test case title to open its comparison view.
  2. Compare the Original and Updated columns field by field.
  3. Read the Reason for update note to see which requirement triggered the change.
  4. Use the arrows to move to the next or previous suggestion.

    Comparison view pairing the Original and Updated columns, with the Reason for update note

The agent lines the two versions up across title, description, preconditions, and steps. Fields that did not change are marked Same as original.

Refine the suggestions (optional)

The first set is a starting point. Type a follow-up prompt, and the agent reworks the set without starting over.

To steer the output, follow these steps:

  1. Select the test cases your prompt should act on, or leave everything unselected to apply it broadly.
  2. Type your instruction, such as β€œadd more negative scenarios”.
  3. Optional: Attach another file or link when the change needs fresh context.
  4. Send the prompt.

    Completed run showing the totals summary and the refine prompt box with suggested follow-up prompts

Accept a test to lock it against later prompts. Reject a suggestion to steer the agent away from similar ones. Anything left untouched carries over unchanged. Click Start Over to discard the run and return to your original requirements.

The agent can make mistakes. Review every suggestion against your requirements before you accept it.

Accept the changes

When the suggestions look right, follow these steps:

  1. Select the test cases you want to act on.
  2. Choose one of the following actions:
Action What happens
Accept Applies the selected suggestions to your repository. Existing tests are updated in place. New tests are added to your selected folder.
Reject Dismisses the selected suggestions. The matching test cases stay exactly as they were.
Refine Sends the agent a follow-up prompt to adjust the suggestions before you accept them.

Accepted updates stay in their current folders. New tests are saved in the folder you selected when you started the run.

Test Case Maintenance Agent vs. Test Case Generator Agent

Both agents turn requirements into test cases. But they solve different problems.

Aspect Test Case Maintenance Agent Test Case Generator Agent
Starting point A repository that needs to catch up to changed requirements A new testing need with no existing coverage
What it does Updates existing tests and adds only the tests you are missing Creates new test cases from scratch
Best for Keeping coverage current after a spec changes Building coverage for a new feature

Use the Test Case Maintenance Agent when you already have a repository and a requirement changed. Use the Test Case Generator Agent when you are building coverage from scratch.

Best practices

  • Scope each run to the folders the change affects. A tighter scope means a faster, cleaner review.
  • Share the most specific requirement you have. A precise spec produces precise updates.
  • Read the AI Reasoning note before you accept a scenario. It tells you why the agent thinks each test changed.
  • Treat semantic rewrites with extra care. Compare the original and updated steps so an edit does not quietly change what a test verifies.
  • Re-run the agent whenever the same area changes again. The repository stays current with far less manual effort.

Known limitations

  • The agent runs on demand. It does not watch your linked requirements or update tests on its own.
  • The agent changes only the test cases inside the Target Folders you select. Test cases in other folders stay untouched.
  • Every change waits for your review. The agent does not edit a test case until you accept its suggestion.
  • AI suggestions can be wrong. Compare each one against your requirement before you accept it.

Next steps

We're sorry to hear that. Please share your feedback so we can do better

Contact our Support team for immediate help while we work on improving our docs.

We're continuously improving our docs. We'd love to know what you liked





Thank you for your valuable feedback

Is this page helping you?

Yes
No

We're sorry to hear that. Please share your feedback so we can do better

Contact our Support team for immediate help while we work on improving our docs.

We're continuously improving our docs. We'd love to know what you liked





Thank you for your valuable feedback!

Talk to an Expert
Download Copy Check Circle