Design · phase
Phase 5: Test
Validate the prototype against WCAG and the component contract.
/design-test <component-name>Figma
Purpose
The test phase validates the completed prototype against the component contract and WCAG accessibility criteria, producing a pass/fail report.
Prerequisites
Requires .singularskills/design/<component-name>/04-prototype.md from Phase 4; the skill also reads the contract in 02-define.md. Its gate script (scripts/gate.sh) stops the skill if 04-prototype.md is missing; --skip-checks bypasses it after logging a skipped event to .singularskills/log.jsonl.
What It Does
- Reads the component contract and prototype notes
- Checks each contract requirement against the prototype
- Runs
figma_a11y_lintto detect accessibility issues in the Figma component - Generates a scorecard with
figma_a11y_scorecardfor overall a11y health - Validates contrast ratios with
figma_a11y_contrast_check - Simulates color-blind views with
figma_a11y_color_blind_sim - Checks focus order with
figma_a11y_focus_order - Generates a test report with pass/fail for each criterion
- Writes to
.singularskills/design/<component-name>/05-test.md
Output
Creates .singularskills/design/<component-name>/05-test.md containing:
- Contract compliance checklist (pass/fail per requirement)
- WCAG validation results
- Issues found and remediation suggestions
- Overall pass/fail status
After Testing
If the test report identifies issues, iterate by returning to the relevant phase (often prototype or define) to address them. The artifact flow is designed for iteration — update the artifact and re-run downstream phases.