Document runtime diagnostics proof rules for blocked local browser paths
Open
@mehul0810 is already working on this.
Since Jul 7, 2026.
area: admin-ui
area: docs
bug
priority: medium
status: ready
- Dominant language
- PHP
- Stars
- 5
- Forks
- 2
- PR merge metrics
- No merged PRs in 30d
Description
Summary
The current runtime diagnostics blocker exposed a missing repo rule for how diagnostics-related UI proof should be captured, linked, and escalated when browser automation is unavailable.
Evidence
- Runtime diagnostics blocker issue
#169and PR#170rely on an explicit proof gap because browser access tohttps://development.wp.local/returns a Studio/Internal Server Error body outsidestudio wp. - The repo has no durable guidance for when CI Playwright artifacts, Studio screenshots, or CLI-only evidence are acceptable substitutes.
Scope
- Define runtime-diagnostics proof rules for issues and PRs.
- Specify proof-source priority for local browser screenshots, Studio parity, CI Playwright artifacts, and CLI evidence.
- Require explicit blocker notes when browser proof cannot be captured locally.
- Clarify how diagnostics-specific regressions should be documented without stalling unrelated release work.
Acceptance criteria
- The repo has a documented proof rule for runtime diagnostics UI work.
- Contributors know what evidence is required before and after a diagnostics change.
- Browser-path blockers must be recorded explicitly with the failed environment and fallback proof source.
- Issue/PR threads can link to one canonical repo policy instead of re-explaining the proof rules each time.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.