Skip to content

chore(accessibility): deprecate the accessibilityExpert tool - #542

Open
Aaryan430 wants to merge 4 commits into
mainfrom
chore/a11y-expert-deprecation
Open

Aaryan430 wants to merge 4 commits into
mainfrom
chore/a11y-expert-deprecation

Conversation

@Aaryan430

@Aaryan430 Aaryan430 commented Nov 3, 2026 •

Copy link
Copy Markdown
Collaborator

Why

accessibilityExpert is going away, and product has been notified. #512 removed it outright, but that was reverted (f9ebfee) because the tool was still in use: about 700 calls from about 120 users in 30 days. The agreed path was a deprecation first, naming what to use instead, and the removal in a later release. This is the deprecation.

What changed

  • Still answers. It keeps answering from BrowserStack's accessibility knowledge base, so nothing that calls it breaks.
  • Says it is deprecated where an agent picks tools. The description starts "Deprecated, to be removed" and the title reads "Accessibility Expert (deprecated)".
  • Each answer starts with a note that names what to use instead:
    • to list or filter a report's issues (for example, those failing a WCAG criterion): fetchAccessibilityIssues;
    • to scan a page: startAccessibilityScan;
    • for advice on a report, such as how to raise its score or which issues to fix first: askBrowserStackAI with product: a11y, giving the user its answer;
    • if askBrowserStackAI is not enabled for the account, answer from the report's issues.
  • Docs. docs/TOOLS.md marks it deprecated.

This is #512's first commit (0be9a14) on current main, with the note now naming what to use instead.

Verified

  • Lint, prettier, tsc and vitest all pass (127 files, 1836 tests).
  • Live, in an isolated claude -p session with a strict MCP config: asked "what contrast ratio does normal body text need under WCAG 2.2 AA?", the agent called the tool and got the note and the answer, and answered 4.5:1. That run used the earlier wording of the note.

Next

Remove the tool in a later release, once telemetry shows calls have dropped off. The removal is #512's second commit (e8b8ac9).

🤖 Generated with Claude Code

accessibilityExpert is going away. Until it is removed it keeps answering from
BrowserStack's accessibility knowledge base, so nothing that calls it breaks. Its
description and title now say it is deprecated, each answer starts with a note that it
will be removed and what to use instead (answer general WCAG questions directly; use
startAccessibilityScan or fetchAccessibilityIssues for a page's or a report's issues), and
docs/TOOLS.md marks it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented Nov 3, 2026 •

Copy link
Copy Markdown

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

Run configuration

  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: Central YAML (base), Organization UI (inherited), Workspace UI (inherited); Enforced overrides: Organization
  • Review profile: ASSERTIVE
  • Plan: Enterprise
  • Run ID: 7e89d7bd-8064-45be-96f0-feae60f3c09c

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • Trigger review
Pre-merge checks: Passed 1 · Inconclusive 1

Failed Failed checks: 1 inconclusive

Check name Status Explanation Resolution
Title check Pending This assessment has not completed. The check will be retried on the next pre-merge check run.
Passed Passed checks: 1 passed

Check name Status Explanation
Description Check Passed Check skipped - CodeRabbit’s high-level summary is enabled.
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Aaryan430 and others added 2 commits November 5, 2026 17:02
…skBrowserStackAI for advice

Listing or filtering a report's issues goes to fetchAccessibilityIssues; advice on a
report, such as raising its score or what to fix first, goes to askBrowserStackAI.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
SavioBS629
SavioBS629 previously approved these changes Nov 11, 2026
Resolves the conflicts with #566 and #568:
- accessibilityExpert answers start with the deprecation note, then main's
  "question was shortened" note when the question was cut, then the answer.
- docs/TOOLS.md keeps main's re-run wording for startAccessibilityScan and
  marks accessibilityExpert deprecated.
- accessibilityExpertQuery tests now expect the deprecation note first.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants