Skip to content

docs(rf-web): add selector-drift triage - #16

Open
ai94iq wants to merge 3 commits into
MarketSquare:mainfrom
ai94iq:docs/selector-drift
Open

ai94iq wants to merge 3 commits into
MarketSquare:mainfrom
ai94iq:docs/selector-drift

Conversation

@ai94iq

@ai94iq ai94iq commented Nov 15, 2026 •

Copy link
Copy Markdown

Adds a selector drift reference to rf-browser.

Verified: catalog, governance, plugin references and docs voice checks pass.

What this changes

Helps tell a test defect from an app defect, uses the locator order from the rf-browser skill, and reruns one failing test three times to call it flaky.

Review checklist

Tick each item, or write "n/a: " after it. Reviewers don't approve a PR
with an unticked item that has no reason (see CONTRIBUTING.md, "Review").

  • Purpose. Each new or changed skill and subagent says what it is for and when to use it, in its description. n/a: no skill description change, only a new reference
  • Supported versions. catalog.yaml lists the libraries and version ranges the content was checked against, and the Robot Framework range. n/a: no new library, catalog.yaml is unchanged
  • Examples. .robot examples pass robot --dryrun; Python examples run. n/a: no examples
  • Security-relevant changes. Hooks, scripts, MCP configuration, manifests, subagent tools and skill allowed-tools changes are listed below; the security gate passes, and any new baseline entry has a reason. n/a: no hook, script, manifest or tools change
  • Tool permissions. Every subagent declares an explicit tools list; no allowed-tools entry grants unrestricted shell access. n/a: no subagent or allowed-tools change
  • Documentation voice. Text follows the writing rules in CONTRIBUTING.md and passes the docs voice check.

Security-relevant changes

none

Add a reference for selector drift and flaky UI tests to rf-browser.
It covers telling a test defect from an app defect, locator choice
and the rerun rules for new tests.
@ai94iq
ai94iq requested a review from manykarim as a code owner November 15, 2026 07:48
@ai94iq

ai94iq commented Nov 15, 2026

Copy link
Copy Markdown
Author

Merge chain: #11, then #12, then #13, then #14, then #15, then #16.

All six merge into main cleanly in this order (dry run on 2026-11-15).

Apart from #13 and #15, the PRs do not depend on each other.

Add selector-drift.md to the rf-browser 'When to read the references'
table and remove its link to locators.md, so references stay one level
deep. Mirrored in the rf-agentskills bundle.

This branch has not been deployed

No deployments
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.

1 participant