Avalia qualidade UX de um projeto comparando screenshots reais contra a Design Library (24 solucoes + design system). Captura telas via Playwright, pontua aderencia a tokens/patterns, identifica desvios. Produz UX Compliance Report.
The English summary is being prepared. Showing the original description.
Review the instructions the agent will receive before you install.
Avalia a qualidade visual/UX de um projeto comparando o que foi implementado contra o padrao da empresa (Design Library + Design System). Captura screenshots reais, compara contra as solution specs, e produz um UX Compliance Report com score e acoes.
Diferenca de outros skills:
ag-revisar-ux: Review pontual com heuristicas de Nielsen (generico)ag-testar-ux-qualidade: UX-QAT PDCA com design tokens (testes continuos)ag-meridian D4-LOOKS: Score visual generico (4 viewports)/ag-avaliar-ux-design-library http://localhost:3000
/ag-avaliar-ux-design-library http://localhost:3005 --scope "/dashboard,/consultas"
/ag-avaliar-ux-design-library ~/Claude/GitHub/salarios-platform --threshold 80
~/Claude/assets/design-library/~/Claude/assets/design-library/UI_UX/raiz-educacao-design-system.mdDISCOVER → CAPTURE → MATCH → EVALUATE → REPORT
--scope especificado, filtrar rotasPara cada tela identificada:
browser_navigatebrowser_wait_for)browser_take_screenshot({ type: "png", filename: "ux-compliance/{slug}-desktop.png", fullPage: true })
browser_resize({ width: 375, height: 812 })
browser_take_screenshot({ type: "png", filename: "ux-compliance/{slug}-mobile.png" })
browser_resize({ width: 1440, height: 900 }) # restaurar
browser_console_messages)Para cada tela capturada:
~/Claude/assets/design-library/catalog.md| Tipo de tela detectado | Solution esperada |
|---|---|
| Dashboard com KPIs | 01-dashboard-kpi |
| Tabela com dados | 02-table-filters-export |
| Formulario multi-step | 03-forms-multistep |
| Timeline/historico | 04-status-workflow-timeline |
| Layout principal | 05-app-shell-sidebar |
| Workflow visual | 06-workflow-builder |
| Chat/AI | 07-chat-ai-streaming |
| Viewer PDF | 08-pageflip-3d |
| Kanban/board | 11-dragdrop-virtual-scroll |
| Export/docs | 12-document-generation |
| RAG/busca | 13-rag-knowledge-base |
| Graficos/BI | 15-bi-data-explorer |
| Contratos | 17-contract-lifecycle |
~/Claude/assets/design-library/solutions/NN-id/spec.mdPara cada tela, avaliar 6 dimensoes (0-10 cada):
Ler ~/Claude/assets/design-library/UI_UX/raiz-educacao-design-system.md e verificar no screenshot + snapshot:
Se solution matched:
UXC = D1*0.20 + D2*0.25 + D3*0.20 + D4*0.15 + D5*0.10 + D6*0.10
| UXC | Status | Significado |
|---|---|---|
| 90-100 | Excelente | Totalmente alinhado com Design Library |
| 80-89 | Bom | Pequenos desvios, aceitavel (threshold default) |
| 65-79 | Regular | Desvios significativos, precisa ajustes |
| 50-64 | Fraco | Implementacao diverge bastante do padrao |
| < 50 | Critico | Nao segue o padrao da empresa |
Salvar em docs/ux-compliance-{date}.md:
# UX Compliance Report — {Projeto}
**Data**: YYYY-MM-DD
**URL**: {url}
**Telas avaliadas**: N
**UXC Score**: XX/100
## Resumo por Tela
| Tela | Solution Ref | D1 | D2 | D3 | D4 | D5 | D6 | Score | Status |
|------|-------------|----|----|----|----|----|----|-------|--------|
| /dashboard | dashboard-kpi | 8 | 7 | 9 | 8 | 7 | 9 | 79 | Regular |
| /usuarios | table-filters | 9 | 8 | 8 | 7 | 8 | 9 | 82 | Bom |
## Desvios Criticos (P0)
- [screenshot] Tela X usa cor #FF0000 em vez de #F7941D (token violation)
- [screenshot] Form sem labels (a11y violation)
## Desvios Importantes (P1)
- Tela Y nao usa KPI card padrao (reinventou componente)
- Spacing inconsistente no header (12px vs 16px padrao)
## Gaps na Design Library
- Tela Z nao tem solution equivalente → sugerir criacao de solution spec #25
## Screenshots
- `ux-compliance/dashboard-desktop.png`
- `ux-compliance/dashboard-mobile.png`
- ...
## Acoes Recomendadas
1. [P0] Corrigir cores para tokens do design system
2. [P1] Substituir KPI custom por `dashboard-kpi` solution
3. [P2] Adicionar nova solution spec para tela Z
Pode ser chamado na fase REVIEW para verificar compliance antes de SHIP:
REVIEW = ag-revisar-codigo + ag-avaliar-ux-design-library (se UI)
Complementa D4-LOOKS com verificacao contra padrao interno:
Desvios P0/P1 podem ser passados como input para correcao automatica:
/ag-2-corrigir lista: [desvios do UX Compliance Report]
No reviews yet. Tell others what you thought.
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
Security audit, hardening, threat modeling (STRIDE/PASTA), Red/Blue Team, OWASP checks, code review, incident response, and infrastructure security for any project.
The English summary is being prepared. Showing the original description.
Guides the creation of agile user stories and Gherkin feature files. Use when the user wants to create a user story, write acceptance criteria, define Gherkin scenarios, or author BDD feature files. This should trigger for requests such as Create a user story; Write a user story; I need to write a user story. Part of cursor-rules-java project
The English summary is being prepared. Showing the original description.
Facilitates conversational discovery to create Architectural Decision Records (ADRs) for non-functional requirements using the ISO/IEC 25010:2023 quality model. Use when the user wants to document quality attributes, NFR decisions, security/performance/scalability architecture, or design systems with measurable quality criteria. This should trigger for requests such as Create ADR for Non-functional requirements; Document Non-functional requirements; Capture Non-functional requirements; Generate Non-functional requirements in an ADR. Part of cursor-rules-java project
The English summary is being prepared. Showing the original description.
Run a health check on an existing project: dependency audit, security scan, test runner detection, CI/CD evaluation, and missing configuration analysis. Maps the three execution gates (pre/in/post) from /10x-bootstrapper to an assessment framework for existing codebases. Reads optional context/foundation/stack-assessment.md from /10x-stack-assess to focus checks on identified gaps. Writes context/foundation/health-check.md with findings, prioritized fixes, and an agent-readiness verdict. Use when the user has an existing project and wants to verify its health before working with an agent. Trigger phrases: "health check", "check my project", "audit my project", "is my project healthy", "sprawdź projekt", "audyt projektu", "health-check", "project health". Use AFTER /10x-stack-assess (brownfield chain), BEFORE agent onboarding (m1-l4).
The English summary is being prepared. Showing the original description.
You MUST use this when building projects end-to-end. Orchestrates all 12 team roles — automatically switches between CTO, architect, PM, engineers, SRE, security, DBA, QA, and EM based on the current phase of work. Starts with brainstorming before any implementation.
The English summary is being prepared. Showing the original description.
Use when you need to add or configure Maven plugins in your pom.xml — including quality tools (enforcer, surefire, failsafe, jacoco, pitest, spotbugs, pmd), security scanning (OWASP), code formatting (Spotless), version management, container image build (Jib), build information tracking, and benchmarking (JMH) — through a consultative, modular step-by-step approach that only adds what you actually need. This should trigger for requests such as Add Maven plugins in pom.xml; Improve Maven plugins in pom.xml. Part of cursor-rules-java project
The English summary is being prepared. Showing the original description.