Skip to content

Commit c0589a9

Browse files
docs(prompts): make QA steps more explicit
1 parent ba3a9c1 commit c0589a9

File tree

1 file changed

+15
-0
lines changed

1 file changed

+15
-0
lines changed

docs/prompts/component-validation-qa-template-prompt.md

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -39,6 +39,11 @@ Workflow I want you to follow:
3939
- any Figma comparison notes I should keep in mind
4040
- any breakpoint-specific token expectations I should keep in mind for mobile / tablet / desktop
4141
- 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
4247
4. Then walk me through that QA script one step at a time.
4348
5. After each step, stop and wait for my response in the format:
4449
- `pass`
@@ -68,6 +73,15 @@ Important constraints:
6873
- 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.
6974
- 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.
7075
- 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.
7185
- Include exact URLs for every QA step.
7286
- Keep the flow interactive. Do not skip ahead after giving me a step.
7387
- 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:
7791
- Be practical and direct.
7892
- Give me exact URLs for QA.
7993
- 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.
8095
- When something fails, explain it plainly and fix it before moving on.
8196
- Keep the summary concise and useful for handing off into PR-readiness work.
8297
```

0 commit comments

Comments
 (0)