Skip to content

docs(rf-core): add failure fingerprints to debug - #14

Open
ai94iq wants to merge 2 commits into
MarketSquare:mainfrom
ai94iq:docs/failure-fingerprints
Open

ai94iq wants to merge 2 commits into
MarketSquare:mainfrom
ai94iq:docs/failure-fingerprints

Conversation

@ai94iq

@ai94iq ai94iq commented Nov 15, 2026 •

Copy link
Copy Markdown

Adds failure fingerprints to the rf-debug-expert subagent.

Verified: build-agent-variants --check passes (7 variants up to date). Catalog, governance, plugin references and docs voice checks pass.

What this changes

Groups failures by a fingerprint of the error message, so the same failure in a later run matches a known cause. Says RequestsLibrary puts the actual value first in its messages.

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: the subagent description is unchanged
  • 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: subagent text only, its tools list is unchanged
  • Tool permissions. Every subagent declares an explicit tools list; no allowed-tools entry grants unrestricted shell access. n/a: tools list unchanged
  • Documentation voice. Text follows the writing rules in CONTRIBUTING.md and passes the docs voice check.

Security-relevant changes

none

Add a fingerprint step and a rule-out checklist to rf-debug-expert.
The agent names each failure group by a stable signature and checks
the test before it reports an app or environment cause. The bundle
and the agent variants are regenerated from the plugin.
@ai94iq
ai94iq requested a review from manykarim as a code owner November 15, 2026 07:47
Section 6 now says RequestsLibrary puts the actual value first and that
other libraries order it differently. Section 2 now says the fingerprint
goes in the bug title or BUGS.md entry. Same text in all four copies.

Checked: cmp of plugin and bundle copies is identical; grep finds no bare
python scripts/ command. scripts/check-drift.sh could not run: Git Bash
python is the Windows Store alias (log ../drift.log).
@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.

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