Skills › gstack › qa › qa-report-template.md

qa-report-template.md

124 lines · qa/templates/qa-report-template.md at 3f79d81

1# QA Report: {APP_NAME}

2

3| Field | Value |

4|-------|-------|

5| **Date** | {DATE} |

6| **URL** | {URL} |

7| **Branch** | {BRANCH} |

8| **Commit** | {COMMIT_SHA} ({COMMIT_DATE}) |

9| **PR** | {PR_NUMBER} ({PR_URL}) or "—" |

10| **Tier** | Quick / Standard / Exhaustive |

11| **Scope** | {SCOPE or "Full app"} |

12| **Probe budget / guarded command time** | {CONFIGURED LIMIT / SUM OF MEASURED COMMAND SPANS} |

13| **Pages visited** | {COUNT} |

14| **Screenshots** | {COUNT} |

15| **Framework** | {DETECTED or "Unknown"} |

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"}
Probe budget / guarded command time	{CONFIGURED LIMIT / SUM OF MEASURED COMMAND SPANS}
Pages visited	{COUNT}
Screenshots	{COUNT}
Framework	{DETECTED or "Unknown"}

Raw lines 1 to 16

17## Health Score: {SCORE}/100

19| Category | Score |

20|----------|-------|

21| Console | {0-100} |

22| Links | {0-100} |

23| Visual | {0-100} |

24| Functional | {0-100} |

25| UX | {0-100} |

26| Performance | {0-100} |

27| Accessibility | {0-100} |

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}

Raw lines 17 to 28

29## Top 3 Things to Fix

311. **{ISSUE-NNN}: {title}** — {one-line description}

322. **{ISSUE-NNN}: {title}** — {one-line description}

333. **{ISSUE-NNN}: {title}** — {one-line description}

Top 3 Things to Fix

{ISSUE-NNN}: {title} — {one-line description}
{ISSUE-NNN}: {title} — {one-line description}
{ISSUE-NNN}: {title} — {one-line description}

Raw lines 29 to 34

35## Console Health

37| Error | Count | First seen |

38|-------|-------|------------|

39| {error message} | {N} | {URL} |

Console Health

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

Raw lines 35 to 40

41## Summary

43| Severity | Count |

44|----------|-------|

45| Critical | 0 |

46| High | 0 |

47| Medium | 0 |

48| Low | 0 |

49| **Total** | **0** |

Summary

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

Raw lines 41 to 50

51## Issues

Issues

Raw lines 51 to 52

53### ISSUE-001: {Short title}

55| Field | Value |

56|-------|-------|

57| **Severity** | critical / high / medium / low |

58| **Category** | visual / functional / ux / content / performance / console / accessibility |

59| **URL** | {page URL} |

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

63**Repro Steps:**

651. Navigate to {URL}

66 ![Step 1](screenshots/issue-001-step-1.jpg)

672. {Action}

683. **Observe:** {what goes wrong}

69 ![Result](screenshots/issue-001-result.jpg)

71---

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:

Navigate to {URL} [image: Step 1]
{Action}
Observe: {what goes wrong} [image: Result]

Raw lines 53 to 72

73## Fixes Applied (if applicable)

75| Issue | Fix Status | Commit | Files Changed |

76|-------|-----------|--------|---------------|

77| ISSUE-NNN | verified / best-effort / reverted / deferred | {SHA} | {files} |

Fixes Applied (if applicable)

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

Raw lines 73 to 78

79### Before/After Evidence

81#### ISSUE-NNN: {title}

82**Before:** ![Before](screenshots/issue-NNN-result.jpg) — the Phase 5 evidence (`issue-NNN.png` for a static bug)

83**After:** ![After](screenshots/issue-NNN-after.jpg)

85---

Before/After Evidence

ISSUE-NNN: {title}

Before: [image: Before] — the Phase 5 evidence (issue-NNN.png for a static bug) After: [image: After]

Raw lines 79 to 86

87## Regression Tests

89| Issue | Test File | Status | Description |

90|-------|-----------|--------|-------------|

91| ISSUE-NNN | path/to/test | committed / deferred / skipped | description |

Regression Tests

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

Raw lines 87 to 92

93### Deferred Tests

95#### ISSUE-NNN: {title}

96**Precondition:** {setup state that triggers the bug}

97**Action:** {what the user does}

98**Expected:** {correct behavior}

99**Why deferred:** {reason}

101---

Deferred Tests

ISSUE-NNN: {title}

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

Raw lines 93 to 102

103## Ship Readiness

105| Metric | Value |

106|--------|-------|

107| Health score | {before} → {after} ({delta}) |

108| Issues found | N |

109| Fixes applied | N (verified: X, best-effort: Y, reverted: Z) |

110| Deferred | N |

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

114---

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."

Raw lines 103 to 115

116## Regression (if applicable)

118| Metric | Baseline | Current | Delta |

119|--------|----------|---------|-------|

120| Health score | {N} | {N} | {+/-N} |

121| Issues | {N} | {N} | {+/-N} |

123**Fixed since baseline:** {list}

124**New since baseline:** {list}

Regression (if applicable)

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

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

Raw lines 116 to 124