| name | qa-evidence |
| description | [QA Method] Evidence capture & report formatting: screenshot rules, 3-tier verbosity, output paths. |
| argument-hint | [compact|detailed|signoff] |
/qa-evidence — Evidence Capture & Output Standards
Apply the project's evidence capture policy and output path conventions. Use before any test execution session to ensure consistent artifact collection.
Usage
/qa-evidence # Full policy review (capture rules + output paths)
/qa-evidence compact # Compact reporting tier rules
/qa-evidence detailed # Detailed reporting tier rules
/qa-evidence signoff # Sign-off reporting tier rules
Supporting Files
- evidence-capture-policy.md — When/how to capture screenshots, console logs, HAR files; 3-tier report verbosity (Compact/Detailed/Sign-Off); bug report size guide; naming conventions
- output-paths.md — Where to save every artifact type (test docs →
tests/, bugs → reports/bugs/, regression → reports/regression/, raw browser output → test-results/)
- sign-off-templates.md — Consolidated frontend + backend sign-off tables, quick status reports (Teams format), approval criteria, escalation triggers
Quick Reference
Mandatory Captures
| When | What | Naming |
|---|
| Test FAILS | Failure state screenshot | {TC-ID}-FAIL-{description}.png |
| Bug found | Bug evidence (annotated) | BUG-{name}-evidence.png |
| Visual regression | Before/after comparison | {component}-{state}-{viewport}.png |
| Critical flow final state | Confirmation/success page | {flow}-final-state.png |
| Error state | Console panel, network 500, error toast | {TC-ID}-error-{type}.png |
Skip Capturing
- Every step of a passing test (noise)
- Loading spinners, login page (unless testing auth)
- Same page in multiple browsers if all pass
- Redundant screenshots of the same bug
Report Verbosity Tiers
| Tier | Use When | Content |
|---|
| Compact | Regression suite pass, smoke run | Pass/fail table + bug list only |
| Detailed | Sprint testing, JIRA ticket testing | Full test case results + evidence |
| Sign-Off | Pre-release, stakeholder review | Detailed + summary + risk assessment |
Output Paths
| Artifact | Directory |
|---|
| Test docs (plans, cases, reports) | reports/tickets/SprintXX-XX/VCST-XXXX/ |
| Screenshots (test evidence) | reports/tickets/SprintXX-XX/VCST-XXXX/screenshots/ |
| Bug reports | reports/bugs/ |
| Bug evidence | reports/bugs/screenshots/, reports/bugs/api-traces/ |
| Regression reports | reports/regression/ |
| Raw browser artifacts (gitignored) | test-results/{browser}/ |
Rules
- Read supporting files for full details before any test session
- Never save test documentation into
test-results/ (gitignored)
- Never save raw browser dumps into
tests/ or reports/ (tracked)
- 1-2 screenshots per bug is enough, not 5