Designesy

Evalúa cualquier URL contra un contrato de sistema de diseño de 40 verificaciones: tokens, movimiento, accesibilidad, cadencia, tipografía. Calificación de A a F, integración SARIF con CI.

GitHubPrueba este MCPPatrocinado

Documentación

Designesy

designesy.org — verificación de contratos de sistemas de diseño, puntuación y herramientas de revisión para agentes de IA.

Inicio rápido

Puntúa cualquier URL en 5 segundos — sin instalación:

npx designesy-score@latest https://your-site.com

Añádelo a Claude Desktop, Cursor o cualquier cliente MCP:

# Remote (zero install, no auth):
claude mcp add designesy --transport http https://www.designesy.org/api/mcp

# Or local stdio via PyPI:
pip install designesy-mcp && designesy-mcp

¿Clonar este repositorio? El .mcp.json en la raíz registra automáticamente el servidor en Cursor y Claude Code — solo abre el proyecto.

Controla tu CI con el cumplimiento del contrato de diseño:

- uses: LE-VAI/designesy-org@v1
  with:
    url: https://your-app.vercel.app
    min-score: 70
    min-grade: B
    post-comment: true   # posts a summary comment on PRs (default)

El mismo motor de 40 verificaciones impulsa un servidor MCP (17 herramientas para agentes de IA), una CLI sin dependencias (npx designesy-score), una GitHub Action y un ranking en vivo en designesy.org/leaderboard.

Designesy Contract Check es una GitHub Action que puntúa cualquier URL contra un contrato de sistema de diseño de 40 verificaciones — tokens, movimiento, accesibilidad, cadencia, takt, compostura, identidad, interacción, rendimiento, responsive, semántica, seguridad, especificaciones, redacción — y hace fallar tu flujo de CI cuando la puntuación o la calificación cae por debajo de tu umbral. Sin LLM, sin heurísticas, sin impresiones subjetivas: cada verificación es determinista, reproducible y fundamentada en un contrato publicado.

Herramientas

designesy_score — Puntúa una URL en vivo contra el contrato de diseño de 40 verificaciones. Devuelve puntuación, calificación (A–F) y desglose por verificación.
designesy_tokens_score — Valida un archivo de tokens de diseño DTCG. 10 verificaciones de conformidad contra W3C DTCG 2025.10.
designesy_a11y_score — Obtén el marco de accesibilidad WCAG 2.2 AA y la plantilla de script Playwright/axe-core.
designesy_motion_score — Valida un archivo de animación Lottie. 10 verificaciones contra la especificación Lottie v1.0.1 y los estándares de movimiento §16.
designesy_contract — Obtén el contrato del sistema de diseño (tokens, movimiento, takt, cadencia, tipografía, verificación).
designesy_catalog — Lista los 12 paquetes publicados de Designesy con versiones y URLs.
designesy_design_review — Obtén la rúbrica de revisión de diseño cualitativa de 8 dimensiones.
designesy_skill_md — Obtén el contrato como SKILL.md en formato de habilidad de agente para Cursor, Claude Code o Replit.
designesy_agent_json — Obtén el documento de descubrimiento /.well-known/agent.json.
designesy_llms_txt — Obtén el resumen breve de agente /llms.txt.
designesy_llms_full_txt — Obtén el resumen completo de agente /llms-full.txt con prompt listo para pegar.

Tabla de referencia de herramientas

Herramienta	Descripción
`designesy_score`	Puntúa una URL en vivo contra el contrato de diseño de 40 verificaciones — devuelve puntuación, calificación (A–F), desglose por verificación
`designesy_tokens_score`	Valida un archivo de tokens de diseño DTCG (10 verificaciones de conformidad, W3C DTCG 2025.10)
`designesy_a11y_score`	Obtén el marco de accesibilidad WCAG 2.2 AA + plantilla de script Playwright/axe-core
`designesy_motion_score`	Valida un archivo de animación Lottie (10 verificaciones, especificación Lottie v1.0.1 + estándares de movimiento §16)
`designesy_contract`	Obtén el contrato del sistema de diseño (tokens, movimiento, takt, cadencia, tipografía, verificación)
`designesy_catalog`	Lista los 12 paquetes publicados de Designesy con versiones y URLs
`designesy_design_review`	Obtén la rúbrica de revisión de diseño cualitativa de 8 dimensiones
`designesy_skill_md`	Obtén el contrato como SKILL.md en formato de habilidad de agente (para Cursor/Claude Code/Replit)
`designesy_agent_json`	Obtén el documento de descubrimiento /.well-known/agent.json
`designesy_llms_txt`	Obtén el resumen breve de agente /llms.txt
`designesy_llms_full_txt`	Obtén el resumen completo de agente /llms-full.txt con prompt listo para pegar

En vivo

Sitio: designesy.org
Endpoint MCP: designesy.org/api/mcp (HTTP Streamable, sin autenticación)
Puntúa un sitio: designesy.org/score
Ranking: designesy.org/leaderboard — 30 sitios puntuados
Metodología: designesy.org/methodology — metodología completa de puntuación de 40 verificaciones
Contrato: designesy.org/contracts/design-system
Exportación de máquina: designesy.org/contracts/design-system.json

Verificación del contrato

El sitio en vivo está verificado contra el contrato del sistema de diseño — 40 verificaciones deterministas con trazabilidad hasta los tokens. Puntuación actual: 95.3% (Calificación A) — 33 aprobadas, 0 fallidas, 3 con advertencia, 1 omitida, 3 manuales (verificaciones solo de navegador). Consulta la página de metodología para ver cómo se calcula la puntuación.

Contrato v0.4.0

40 verificaciones en 14 categorías ponderadas — tokens, movimiento, accesibilidad, cadencia, takt, compostura, identidad, interacción, rendimiento, responsive, semántica, seguridad, especificaciones, redacción
Principios de redacción (v0.4.0) — 16 principios de redacción UX + 4 verificaciones (frases verbales en botones, sin puntos finales, texto de enlace descriptivo, sin TODO EN MAYÚSCULAS)
10 estándares de movimiento no negociables — easing deliberado, propiedades explícitas, entradas con opacidad, quietud del teclado, sin animación de layout, control táctil, duración limitada, rutas de movimiento reducido, pulsación asimétrica, sin ease-in
10 señales acústicas — $type: sound personalizado (nuevo vs W3C DTCG 2025.10), motor Cuelume v0.1.0, solo interacción
9 tensiones abiertas — documentadas, no ocultas
Física de resortes — tokens de momentum y predeterminados mediante $type: spring personalizado
Legible por máquina — formato W3C DTCG 2025.10 + extensiones personalizadas

Consulta la página del contrato para el historial completo de adopción.

GitHub Action

Controla tu CI con el cumplimiento del contrato de diseño:

- uses: LE-VAI/designesy-org@v1
  with:
    url: https://your-app.vercel.app
    min-score: 70
    min-grade: C
    post-comment: true   # posts a summary comment on PRs (default)

Puntúa una URL mediante el motor /api/score en vivo y hace fallar el flujo de trabajo si la puntuación o la calificación cae por debajo de tu umbral. Se ejecuta en node24, publica comentarios en PR mediante la API REST de GitHub (cero dependencias). Consulta action/README.md para el uso completo.

CLI

Puntúa una URL desde la línea de comandos — para desarrollo local, hooks de pre-commit o scripts:

# Local (no install needed):
node cli/designesy-score.mjs designesy.org

# With gating (exit 1 on failure):
node cli/designesy-score.mjs linear.app --min-score 70 --min-grade B

# JSON output for piping:
node cli/designesy-score.mjs vercel.com --format canonical --json

# Via npm script:
npm run score -- designesy.org

Cero dependencias — solo built-ins de Node. La bandera --api o la variable de entorno SCORE_API anula la URL del motor de puntuación (por defecto https://www.designesy.org). Consulta --help para todas las opciones.

Repositorio

Esta es la raíz pública controlada de Designesy — un sitio Next.js 15 App Router (React 19, Turbopack, despliegue en Vercel).

apps/site          Next.js application
action/            designesy/contract-check GitHub Action
cli/               designesy-score CLI
docs/designesy     context, architecture, logs, registries
DESIGN.md          the design contract (human-readable)
AGENTS.md          agent operating rules

Lo que Designesy no es

Designesy no es una galería de plantillas. Designesy no es una herramienta genérica de diseño con IA. Designesy no es un moodboard.

Designesy es un sistema.

Herramientas relacionadas

Lyse — puntuación de salud del sistema de diseño con 258 verificaciones desde tu código (6 ejes). Designesy puntúa cualquier URL pública; Lyse puntúa tu repositorio. Complementarios.
DSAF — auditoría de madurez del sistema de diseño asistida por LLM con 125 criterios en 20 categorías. Designesy es puntuación determinista de URLs; DSAF es evaluación de madurez asistida por LLM. Capas diferentes, mismo objetivo.
axe-core — pruebas de accesibilidad WCAG. Designesy verifica el cumplimiento del contrato de diseño (tokens, movimiento, tipografía) — una capa diferente. Se complementan.
Lighthouse — auditoría de rendimiento, accesibilidad y SEO. Designesy verifica el cumplimiento del contrato de diseño — Lighthouse no sabe qué es un token de diseño.

FAQ

¿Necesita una clave de API? No — las 17 herramientas son de solo lectura. El endpoint MCP es HTTP Streamable sin estado y sin autenticación.

¿Es determinista? Sí. No hay LLM en el bucle de puntuación — cada verificación es determinista y reproducible. La misma URL siempre producirá la misma puntuación.

¿Contra qué puntúa? Contra el contrato de sistema de diseño Designesy v0.4.0 — 40 verificaciones en 14 categorías ponderadas (tokens, movimiento, accesibilidad, cadencia, takt, compostura, identidad, interacción, rendimiento, responsive, semántica, seguridad, especificaciones, redacción).

¿Puedo usarlo en CI? Sí. La GitHub Action controla tu flujo de trabajo según el cumplimiento del contrato — haz fallar la compilación si la puntuación cae por debajo de tu umbral.

¿Dónde se publica el contrato? En designesy.org/contracts/design-system (legible por humanos) y designesy.org/contracts/design-system.json (legible por máquina, W3C DTCG 2025.10).

Licencia

MIT — consulta LICENSE. El contrato es público; el código es de código abierto bajo MIT.