| name | rhdh-plugin-bug-fix |
| description | Reproduces, diagnoses, and fixes a defect in a Backstage plugin inside the rhdh-plugins or community-plugins repositories: resolve the report from a RHIDP, RHDHBUGS, RHDHPLAN or RHDHSUPP Jira key, a GitHub issue, or plain prose; locate the owning workspace; write a throwaway reproduction test that fails for the stated reason; record before and after Playwright video evidence for a UI defect; then apply the smallest fix and verify it. Use for "fix this plugin bug", "reproduce RHIDP-1234", a plugin that renders the wrong thing, or a regression that needs evidence before and after. |
| compatibility | Node.js 22+, Yarn, Git, and a rhdh-plugins or community-plugins checkout; Playwright and ffmpeg for UI evidence; GitHub CLI or Jira access to read the report. |
RHDH Plugin Bug Fix
Own the path from a bug report to a verified fix. Reproduce before diagnosing,
diagnose before editing, and verify before reporting. The reproduction test is
diagnostic evidence and never ships.
Start here
Follow workflows/fix-bug.md from the top. It resolves the issue reference,
triages the report for agent readiness, discovers the workspace, picks the
full-e2e or no-e2e branch, reproduces, fixes, verifies, and cleans up.
Route by outcome
| Outcome | Load and follow |
|---|
| Reproduce, diagnose, and fix a plugin bug | workflows/fix-bug.md |
| Resolve a report to a plugin workspace | references/workspace-map.md |
| Author the temporary Playwright reproduction | references/e2e-patterns.md |
| Capture and convert before and after evidence | references/video-recording.md |
Boundaries
/rhdh-forge owns reading GitHub. Invoke it by name with the raw issue or
pull request reference and consume the structured issue context it returns —
key, summary, URL, repository, number, state, labels, description, and the
candidate workspace with the strategy that resolved it. Confirm that
workspace against the checkout before working in it, and ask the user when
the strategy reports it unresolved. Do not parse the URL or run gh issue view here./rhdh-jira-api owns reading a Jira key and returns the same issue detail./grilling is the design gate when several root causes remain plausible or
materially different fixes carry different compatibility costs. Use the
constraints it produces before implementing. If it is not installed, say so,
name /setup-rhdh-skills install as the human's next step, and pause that branch./rhdh-test-placement advises where a permanent regression test belongs.
The reproduction test written here is throwaway and is deleted before the
change is handed off./rhdh-plugin-authoring owns feature work and public API design./rhdh-pr-create owns staging, changesets, commits, pushes, pull requests,
recording uploads, and issue updates.
Invoke a named skill and describe the handoff in the conversation. Never open
another skill's files.
Invariants
- Reproduce the failure before editing product code. A "before" recording
cannot be reconstructed after the fix.
- The temporary
_repro-<issue>.test.ts is evidence, not a deliverable. Remove
the exact file before handing the change off.
- Discover the workspace's real Playwright configuration, helpers, and
neighbouring tests.
references/workspace-map.md locates a likely workspace;
it does not describe the current test infrastructure.
- Close the Playwright context so each video finalizes, and keep before and
after recordings until publication has consumed them.
- State the root cause with observed evidence before implementing, then make
the smallest fix consistent with the repository's conventions.
- If a test still fails, return to diagnosis. Never weaken an assertion to make
it pass.
- Adding a label or a triage comment to an issue is an external write. Invoke
the named skill
mutation-gate and follow it; the operation's target is
the exact repository and issue number. A request to fix a bug approves no
issue write.
- Do not stage, commit, push, or open a pull request here.
Completion
Report the resolved issue and workspace, the reproduction and what it proved,
the root cause with its evidence, the files changed and left unstaged, the
before and after recording paths, the verification commands and their results,
the test plan a reviewer should run, and the named skill to invoke next for
publication.
