gstack/qa/templates/qa-report-template.md

QA Report: {APP_NAME}

Field	Value
Date	{DATE}
URL	{URL}
Branch	{BRANCH}
Commit	{COMMIT_SHA} ({COMMIT_DATE})
PR	{PR_NUMBER} ({PR_URL}) or "—"
Tier	Quick / Standard / Exhaustive
Scope	{SCOPE or "Full app"}
Duration	{DURATION}
Pages visited	{COUNT}
Screenshots	{COUNT}
Framework	{DETECTED or "Unknown"}
Index	All QA runs

Health Score: {SCORE}/100

Category	Score
Console	{0-100}
Links	{0-100}
Visual	{0-100}
Functional	{0-100}
UX	{0-100}
Performance	{0-100}
Accessibility	{0-100}

Top 3 Things to Fix

1. {ISSUE-NNN}: {title} — {one-line description}
2. {ISSUE-NNN}: {title} — {one-line description}
3. {ISSUE-NNN}: {title} — {one-line description}

Console Health

Error	Count	First seen
{error message}	{N}	{URL}

Summary

Severity	Count
Critical	0
High	0
Medium	0
Low	0
Total	0

Issues

ISSUE-001: {Short title}

Field	Value
Severity	critical / high / medium / low
Category	visual / functional / ux / content / performance / console / accessibility
URL	{page URL}

Description: {What is wrong, expected vs actual.}

Repro Steps:

1. Navigate to {URL}
2. {Action}
3. Observe: {what goes wrong}

---

Fixes Applied (if applicable)

Issue	Fix Status	Commit	Files Changed
ISSUE-NNN	verified / best-effort / reverted / deferred	{SHA}	{files}

Before/After Evidence

ISSUE-NNN: {title}

Before: After:

---

Regression Tests

Issue	Test File	Status	Description
ISSUE-NNN	path/to/test	committed / deferred / skipped	description

Deferred Tests

ISSUE-NNN: {title}

Precondition: {setup state that triggers the bug} Action: {what the user does} Expected: {correct behavior} Why deferred: {reason}

---

Ship Readiness

Metric	Value
Health score	{before} → {after} ({delta})
Issues found	N
Fixes applied	N (verified: X, best-effort: Y, reverted: Z)
Deferred	N

PR Summary: "QA found N issues, fixed M, health score X → Y."

---

Regression (if applicable)

Metric	Baseline	Current	Delta
Health score	{N}	{N}	{+/-N}
Issues	{N}	{N}	{+/-N}

Fixed since baseline: {list} New since baseline: {list}