| name | web-design-guidelines |
| description | Review ArtStroy UI code for Web Interface Guidelines compliance. Use when auditing components, pages, or layouts for accessibility, UX best practices, and interface quality. Fetches the latest Vercel Web Interface Guidelines before each review. |
Web Design Guidelines Review
Review ArtStroy UI files for compliance with Web Interface Guidelines.
How It Works
- Fetch the latest guidelines from the source URL below
- Read the specified files
- Check against all rules in the fetched guidelines
- Output findings in
file:line format
Guidelines Source
Fetch fresh guidelines before each review using an HTTP GET:
https://raw.githubusercontent.com/vercel-labs/web-interface-guidelines/main/command.md
Do this at the start of every review session — the guidelines evolve and must not be cached between reviews.
The fetched content contains all rules and the required output format. Follow that format exactly.
Usage
When given a file path or glob pattern:
- Fetch guidelines from the source URL
- Read the specified files
- Apply all rules from the fetched guidelines
- Output findings using the format specified in the guidelines
If no files are specified, ask which files to review before fetching guidelines.
ArtStroy-Specific Context
When reviewing ArtStroy components, apply additional context:
- Framework: Astro 5 + React 19; components may be
.astro, .tsx, or .mdx
- Styling: Tailwind 4 + DaisyUI 5; semantic class names preferred over arbitrary values
- Images: Astro
<Image> component handles optimization; bare <img> tags for content images are a finding
- Client directives:
client:load vs client:visible — flag any client:load that could be client:visible
- Accessibility: ArtStroy targets a technical professional audience; code blocks, tables, and interactive components need proper ARIA roles
Output Format
Use file:line format for every finding:
src/components/ArticleCard.tsx:42 — missing alt text on image element
src/layouts/Base.astro:15 — lang attribute missing on <html>
src/components/Search.tsx:88 — button lacks accessible label
Group findings by severity if the guidelines define severity levels. Follow whatever format the fetched guidelines specify — that document is authoritative.
