You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/prompts/component-validation-qa-template-prompt.md
+15Lines changed: 15 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -39,6 +39,11 @@ Workflow I want you to follow:
39
39
- any Figma comparison notes I should keep in mind
40
40
- any breakpoint-specific token expectations I should keep in mind for mobile / tablet / desktop
41
41
- any Storybook ↔ docs-site example parity checks that should be validated manually
42
+
- exact statements of what changed in code and what that means in the rendered UI
43
+
- explicit size/spacing/token values I should be validating wherever they are knowable
44
+
- the before/after expectation when the QA is validating a recent change
45
+
- the exact reason those values are expected, not just a vague design note
46
+
- the exact element/class I should inspect in DevTools when visual validation is not enough
42
47
4. Then walk me through that QA script one step at a time.
43
48
5. After each step, stop and wait for my response in the format:
44
49
-`pass`
@@ -68,6 +73,15 @@ Important constraints:
68
73
- Treat Storybook docs-page examples that share effective IDs or form names across stories and interfere with each other as implementation misses to be fixed before QA is considered complete.
69
74
- Treat hard-to-follow nested ternaries or compressed logic as implementation misses when the same behavior can be expressed more clearly with explicit conditionals or small helper variables.
70
75
- If implementation used a temporary internal adapter because a dependency was missing, call that out clearly during QA and include the affected surfaces in the validation script.
76
+
- Do not use vague instructions like "looks shorter" or "feels closer to Figma" when the expected result can be stated precisely.
77
+
- For each QA step, prefer this structure:
78
+
- what changed
79
+
- what exact values or behaviors should now be visible
80
+
- why those values/behaviors are expected
81
+
- how to inspect them if needed
82
+
- what counts as pass
83
+
- If exact values are not knowable, say that plainly and explain what can be validated objectively instead.
84
+
- If you introduce a temporary QA-only tweak to make inspection easier, call it out explicitly, keep it minimal, and revert it before moving on.
71
85
- Include exact URLs for every QA step.
72
86
- Keep the flow interactive. Do not skip ahead after giving me a step.
73
87
- Leave unrelated modified or untracked files alone unless I explicitly ask you to include them.
@@ -77,6 +91,7 @@ Output style I want from you:
77
91
- Be practical and direct.
78
92
- Give me exact URLs for QA.
79
93
- Drive the QA one step at a time.
94
+
- Make each QA step specific enough that a reviewer can validate it without guessing what "good" looks like.
80
95
- When something fails, explain it plainly and fix it before moving on.
81
96
- Keep the summary concise and useful for handing off into PR-readiness work.
0 commit comments