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

_{Un bucle de 12 segundos, grabado desde la página de inicio. Se reproduce una vez y se detiene en el veredicto, y muestra un fotograma fijo si prefieres movimiento reducido. Míralo ejecutarse en designesy.org.}

designesy.org — herramientas de verificación de contratos de sistemas de diseño, puntuación y 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 42 comprobaciones impulsa un servidor MCP (17 herramientas para agentes de IA), una CLI sin dependencias (npx @designesy/score), una GitHub Action y una tabla de clasificación 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 42 comprobaciones — tokens, movimiento, accesibilidad, cadencia, takt, aplomo, identidad, interacción, rendimiento, responsive, semántica, seguridad, especificación, redacción — y hace fallar tu flujo de trabajo de CI cuando la puntuación o la calificación cae por debajo de tu umbral. Sin LLM, sin heurísticas, sin impuestos de vibra: cada comprobació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 42 comprobaciones. Devuelve puntuación, calificación (A–F) y desglose por comprobación.
designesy_tokens_score — Valida un archivo de tokens de diseño DTCG. 10 comprobaciones 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 de Playwright/axe-core.
designesy_motion_score — Valida un archivo de animación Lottie. 10 comprobaciones 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 paquetes publicados de Designesy con versiones y URLs (el recuento vuelve en package_count).
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 breve de agente corto /llms.txt.
designesy_llms_full_txt — Obtén el breve de agente completo /llms-full.txt con un 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 42 comprobaciones — devuelve puntuación, calificación (A–F), desglose por comprobación
`designesy_tokens_score`	Valida un archivo de tokens de diseño DTCG (10 comprobaciones de conformidad, W3C DTCG 2025.10)
`designesy_a11y_score`	Obtén el marco de accesibilidad WCAG 2.2 AA + plantilla de script de Playwright/axe-core
`designesy_motion_score`	Valida un archivo de animación Lottie (10 comprobaciones, 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 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 breve de agente corto /llms.txt
`designesy_llms_full_txt`	Obtén el breve de agente completo /llms-full.txt con un 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
Tabla de clasificación: designesy.org/leaderboard — 30 sitios puntuados
Metodología: designesy.org/methodology — metodología completa de puntuación de 42 comprobaciones
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 comprobaciones deterministas con procedencia de vuelta a los tokens. Puntuación actual: 93% (Calificación A) — 36 aprobadas, 0 fallidas, 0 con advertencia, 1 omitida, 3 manuales (comprobaciones solo de navegador; la omisión es DESIGN.md aún no servido en la raíz del sitio — ver /contracts/design-system). Consulta la página de metodología para saber cómo se calcula la puntuación.

Contrato v0.4.0

40 comprobaciones de verificación en 14 categorías ponderadas — tokens, movimiento, accesibilidad, cadencia, takt, aplomo, identidad, interacción, rendimiento, responsive, semántica, seguridad, especificación, redacción
Principios de redacción (v0.4.0) — 16 principios de redacción UX + 4 comprobaciones de verificación (frases verbales de botones, sin puntos finales, texto de enlace descriptivo, sin MAYÚSCULAS)
10 estándares de movimiento no negociables — easing deliberado, propiedades explícitas, entradas de opacidad, quietud del teclado, sin animación de diseño, 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 resorte — tokens de valor predeterminado + impulso 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 de PR mediante la API REST de GitHub pura (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 de sistemas de diseño de 258 comprobaciones desde tu código base (6 ejes). Designesy puntúa cualquier URL pública; Lyse puntúa tu repositorio. Complementarios.
DSAF — auditoría de madurez de sistemas de diseño asistida por LLM con 125 criterios en 20 categorías. Designesy es puntuación de URL determinista; DSAF es evaluación de madurez asistida por LLM. Capas diferentes, mismo objetivo.
axe-core — pruebas de accesibilidad WCAG. Designesy comprueba 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 comprueba 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 comprobación es determinista y reproducible. La misma URL siempre producirá la misma puntuación.

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

¿Puedo usarlo en CI? Sí. La GitHub Action controla tu flujo de trabajo con 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.