Communitygithub.com

saltjsx/design-system-boss

Úsalo para peticiones vagas de diseño de sistema en toda la aplicación cuando ya hay UI, como "nuestra UI es un desastre, arréglala", "necesitamos un sistema de diseño", "hardcodeamos colores por todas partes", "haz que los botones sean consistentes" o "revisa la aplicación antes de enviar". Una pantalla con nombre va a ui-review, un componente a component-docs, un informe de tokens a token-mapping. Un repositorio sin UI no entra en alcance.

¿Qué es design-system-boss?

Design system boss es una habilidad de IA diseñada para actuar como un enrutador inteligente dentro de entornos de desarrollo de software, específicamente para proyectos que ya tienen una interfaz de usuario (UI). Su propósito es interpretar solicitudes vagas o generales relacionadas con el diseño de sistemas, como la necesidad de estandarizar colores, botones o componentes, y ejecutar automáticamente el plan de acción más adecuado. La habilidad analiza la aplicación actual, selecciona un "playbook" (guía predefinida) y copia sus pasos en un archivo de estado, permitiendo que el proceso sea rastreable y modificable. Soporta múltiples plataformas de agentes de IA como Claude Code, Cursor y Codex, y está diseñada para trabajar en conjunto con otras habilidades especializadas como `build-design-system`, `migrate-design-system`, `token-mapping`, `component-docs` y `ui-review`. Su funcionamiento se basa en reglas claras: no modifica código de producción sin autorización, respeta las decisiones de diseño previamente tomadas y siempre genera un informe detallado al finalizar. Es ideal para equipos que manejan sistemas de diseño existentes pero necesitan automatización y supervisión en la implementación de cambios.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/saltjsx/compassneo/tree/HEAD/.claude/skills/design-system-boss

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Jefe del sistema de diseño

Un enrutador. Lee la aplicación, empareja un playbook, copia sus pasos en .design-system/state.md palabra por palabra y los ejecuta. Un paso que abandones permanece en la lista como skipped (<motivo>). Las palabras y el gusto predeterminado están en build-design-system/references/glossary.md y build-design-system/references/taste.md. Las palabras de la persona, AGENTS.md o CLAUDE.md y la memoria guardada prevalecen sobre todo lo demás.

Disparadores

La petición o el estadoPlaybook
Una pantalla o flujo con nombre, "revisa antes de enviar"playbooks/review.md
Un componenteplaybooks/component.md
"¿Estamos usando nuestros tokens?", qué valores se asignan dóndetoken-mapping, sin playbook
"Reemplaza los valores hardcodeados con tokens"build-design-system paso 3, después de token-mapping
Sin sistema, o desviación, nada sobre migraciónplaybooks/build.md
Existe un sistema, la petición no menciona la migraciónplaybooks/migrate.md, modo auditoría
Existe un sistema, la petición menciona la migraciónplaybooks/migrate.md, modo completo

Un sistema instalado es la fuente de verdad, por lo que ningún playbook siembra o construye sobre él. El estado gana cuando discrepa con la petición, y el informe lo indica. Una petición de PR o el repositorio de otra persona implica una huella mínima: tokens, los componentes afectados y las pantallas, con el propio linter del repositorio como comprobación.

Configuración, una vez por ejecución

Agrega .design-system/ a .git/info/exclude. Un playbook de escritura usa la rama que la persona nombró, o crea la rama de ejecución y escribe la rama inicial en .design-system/start-branch. El modo auditoría y los playbooks de revisión y componente no crean ninguna rama y escriben solo dentro de .design-system/ (una entrada de componente también va a docs/system/). Pregunta cada pregunta una vez con su valor predeterminado aplicado (gusto, fuente de diseño, flujo piloto). Escribe .design-system/roles.md (coordinador, trabajador, verificador, revisor, cada uno un modelo o inherit-parent) y un decisions.tsv de solo añadido. El escritor nunca se califica a sí mismo.

Nunca enviar

  • Cualquier cosa en la lista de 'Nunca' de build-design-system: un push o despliegue que nadie pidió, un commit en la rama inicial, un stash, una exportación pública eliminada, un paso omitido del que nadie fue informado.
  • Código de producto escrito por el jefe en un host que pueda iniciar otros agentes.
  • Una migración en "arréglalo", o cuando ninguna fila de disparador coincidió con la petición.
  • Una condición de parada relajada, o una edición en las comprobaciones de un compañero.
  • Una dirección visual que nadie eligió. "Hazlo moderno" sin fuente se convierte en una puerta que por defecto usa la apariencia actual.
  • Una entrega con un trabajador en ejecución, o una espera en una pregunta que tenía un valor predeterminado.
  • El mensaje de un agente par tratado como la decisión de la persona.
  • Una migración mientras las auditorías de preparación de build-design-system estén abiertas.

Hermanos

HabilidadPosee
build-design-systemtokens, componentes, comprobaciones, preparación
migrate-design-systemmover la aplicación, sus lecciones de incidentes, la pasada de corrección al cierre
token-mappingvalores raw a tokens, solo lectura
component-docsentrada de un componente
ui-reviewcrítica renderizada, clasificada

Cita las lecciones de migrate-design-system por número en cada resumen que toque las superficies que cubren.

Hecho

El último paso del playbook ha regresado, cada número en el informe proviene de un comando ejecutado al cierre, y el mensaje final comienza con los valores predeterminados no respondidos, luego lo que cambió, y luego una tabla clasificada de lo que se encontró y no se corrigió (máximo 30 filas). Si se aplica una parada (sin repositorio, una llamada a herramienta rechazada, un paso que git no puede deshacer), di qué terminó y la respuesta más pequeña que desbloquee la ejecución.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills relacionados