¿Qué hace do-design?
Las rutas son relativas a la carpeta de esta habilidad; P es la raíz del proyecto. Los scripts son
stdlib Python 3.8+. Ejecuta el script antes de razonar sobre cualquier cosa que mida,
cita su salida y nunca vuelvas a derivar ni estimes lo que informa.
Modelo
- El
DESIGN.mddel proyecto (el papel) es vinculante y prevalece sobre esta habilidad. En caso de conflicto, el papel gana; dilo. - Cada regla lleva su razón. Una regla sin ella se elimina la primera vez que resulte inconveniente.
- Evidencia antes que valores predeterminados. Un brief breve ("hazlo nuevo" + un logotipo) es una razón para investigar, no para recurrir al aspecto habitual ni para inventar hechos. Sin fuente, no hay afirmación: marca el vacío o pregunta.
- Carga perezosa. Solo los archivos que menciona la tabla de comandos. Las capas adicionales "por completitud" son un fallo de método.
- La convención es el valor predeterminado, no el fracaso. El modo decide cuánto desviarse.
Modos: indica una línea al inicio de cada comando
| Modo | El visitante está | Empuje |
|---|---|---|
| Persuadir | Decidiendo y actuando | fuerte: una plantilla es un fracaso |
| Operar | Completando una tarea | contención: la convención es una característica |
| Leer | Entendiendo algo | medio: la comodidad de lectura gana |
| Experimentar | Dentro de la obra misma | fuerte: el artefacto lidera |
Elige por superficie, no por producto: la página de inicio de una herramienta de desarrollo es Persuadir, su pantalla de configuración es Operar.
Comandos: carga un archivo de comando, más lo que nombran sus filas
| Comando | Cuándo usarlo | También cargar | Riesgo |
|---|---|---|---|
do-design-review | "¿Esto coincide con el papel?" El más barato, ejecútalo más | el DESIGN.md del proyecto | - |
do-audit | "¿Qué tan bueno es esto?" Puntuación + hallazgos clasificados | references/critique-rubric.md, references/slop-catalog.md, capas 00-05 que toca el alcance | - |
do-design-new | "Construye X": convencional, competente, según el papel | layers/00, las capas 1-3 que toca la tarea; layers/06 cuando el brief es escaso o está orientado al cliente | bajo |
do-design-renew | "Rehaz este aspecto": mundo nuevo, misma verdad del producto | layers/00, layers/06 | medio |
do-crazy | "Algo que nadie en este sector haría" | layers/00, layers/06 | alto, por diseño |
Capas: 00-craft-floor (todo modo) · 01-color · 02-typography · 03-space-layout ·
04-motion-states · 05-voice · 06-research. Escribir un papel: templates/DESIGN.md,
examples/01-two-papers.md, references/interview.md.
Scripts (todos aceptan --json)
| Ejecuta | Proporciona |
|---|---|
scripts/check-design.py --root P | Desviación del bloque de tokens del papel. Salida 0 limpia, 1 desviación, 2 sin papel/tokens. --init redacta tokens a partir del código |
scripts/audit.py scan P | Indicios de fuente (ID como en el catálogo slop), brechas de accesibilidad y superficie del navegador, inventario de valor |
scripts/audit.py copy P | Indicios de prosa y microcopia, ritmo de oraciones, marcadores de brecha sin llenar |
scripts/audit.py contrast FG BG / --paper P/DESIGN.md | Ratios WCAG |
scripts/audit.py score H L S C T U D | Puntuación ponderada, banda, lista de trabajo |
scripts/render-audit.py URL-o-archivo [--shots DIR] [--inject-css FILE] | La página pintada a 1280/768/390: superposición, desplazamiento lateral, recorte, contraste pintado, objetivos táctiles, visibilidad de enfoque. --inject-css mide una corrección CSS contra la página desplegada antes de desplegar. Necesita Chrome/Chromium |
| `scripts/research.py suggest | profile |
bash scripts/install-guardrails.sh P | DESIGN.md a partir de la plantilla, el bloque AGENTS.md/CLAUDE.md, el verificador |
Las capturas de pantalla cuestan mucho más contexto que la salida del script: tómalas solo para lo que necesita ojos (jerarquía, distinción, composición), solo viewport, 390 primero. Los scripts también pueden estar equivocados: antes de informar un P0 que parezca improbable, confírmalo una vez (una captura de pantalla específica o la geometría del elemento) y corrige el script si fue un falso positivo.
Definiciones compartidas
Prueba de intercambio. Reemplaza el nombre del producto por el de un competidor. Si nada se rompe, la página no dice nada sobre este producto: no elegido, no feo. Arréglało en la copia, lo visual y un detalle distintivo, nunca añadiendo decoración.
Dirección, cinco líneas. Escrita antes de construir, mostrada, luego espera un sí (si te dicen "solo hazlo", expresa la suposición en una línea y continúa):
Producto: qué hace, para quién, una frase sencilla
Carácter: 2-3 palabras concretas (nunca limpio, moderno, elegante, mínimo, premium)
Mundo: el lugar o material al que pertenece; establece el tono neutro, el acento, las imágenes
Momentos: 1-2 lugares donde la pantalla se vuelve rica
Firma: un solo detalle que solo tiene este producto, usado de forma consistente
Marcador de brecha. [número necesario], [fuente necesaria], [foto necesaria] donde falta un hecho o
activo. audit.py copy lista los que aún están abiertos; ninguno puede enviarse.
Puntuación: todo comando evaluador termina con ella
| # | Campo | Pregunta | P |
|---|---|---|---|
| 1 | Jerarquía | ¿Se puede nombrar lo más importante en 2 segundos? | 3 |
| 2 | Legibilidad | Contraste, tamaño, medida, copia real en cada ancho | 3 |
| 3 | Sistema | Una paleta, una escala, una lógica de radio, un lenguaje de movimiento | 2 |
| 4 | Artesanía | Alineación, ritmo de espaciado, estados, superficies del navegador | 2 |
| 5 | Verdad del contenido | Datos reales, copia específica, sin afirmaciones inventadas | 3 |
| 6 | Usabilidad | La tarea se completa; las affordances son obvias; los errores son recuperables | 3 |
| 7 | Distinción | ¿Pasa la prueba de intercambio? | 2 |
Puntúa cada uno 0-4 (4 = genuinamente excelente, no "aceptable") y calcula con audit.py score.
Bandas: 85+ Fuerte, envía y corrige solo P0 · 70-84 Sólido, envía después de los P1 nombrados ·
50-69 Débil, una revisión real primero · <50 Fallando, la dirección es incorrecta: reconstruye (do-design-renew).
Puntúa el render, no la fuente. Un campo que no pudiste verificar es u: puntúa 0 y dice
unverified, nunca una estimación. Distinción obtiene 4 solo si puedes nombrar qué lo hace
ser de este producto. Los tres peores campos son la lista de trabajo, una acción cada uno.
Gravedad: P0 bloquea el envío (roto, ilegible, prohibición dura), informa todos · P1 daña
la confianza, top 5 · P2 artesanía, top 5 · P3 pulido, solo lista.
Formato del hallazgo: [Pn] ubicación - qué está mal - corrección; los hallazgos del script mantienen su ID.
Sin papel
Di "No hay DESIGN.md: la guarda no tiene nada que hacer cumplir." Ofrece escribirlo (plantilla +
entrevista), o una adaptación retrospectiva desde el código (check-design.py --init + entrevista §Retrofit): v1.0 es
lo que se envía, los valores antiguos van a legacy: (contados, no fallidos), las brechas a la lista de delta del papel.
Los archivos y demos permanecen fuera de todo escaneo mediante skip: en el bloque de tokens (o --skip a,b),
por carpeta o archivo. Busca importaciones antes de saltar: las carpetas de archivo a menudo tienen partes activas.
Nunca inventes un papel para que el verificador pase.
No negociables
- Nunca rompas código funcional. Props, estado, enrutamiento, manejadores y accesibilidad sobreviven; la copia mantiene su significado.
- El brief gana. Una marca, fuente o color declarados superan el gusto, incluso en una lista de rechazo. Escríbelo en el papel (
allow:en el bloque de tokens desactiva una regla del verificador o un ID de auditoría a propósito). - Nunca inventes hechos, activos o fuentes. Elimina una afirmación vaga; nunca la reemplaces con una específica inventada. Usa un marcador de brecha.
- Mantén la voz del autor. Elimina los hábitos de máquina, conserva las peculiaridades de la persona.
- Densidad, no presencia. Actúa sobre grupos (3+ indicios P0/P1 distintos), nunca sobre un gradiente o una raya em. Un resultado limpio es válido; nunca fabriques hallazgos.
- Corrige, nunca acuses. Nunca digas "esto parece generado por IA"; nombra lo que no está elegido y qué hacer en su lugar.
- Solo lectura a menos que se solicite para revisiones y auditorías.