¿Qué hace Argus?
Conoces las reglas del diseño. Otras cuatro cosas salen mal, y esta habilidad responde a cada una:
- No puedes ver lo que haces. Por lo tanto, construye, mira el resultado renderizado, corrige y vuelve a mirar.
- Tu primera idea es la primera idea de todos. Así que toma información del exterior: lo que existe, lo que el usuario dice, lo que te muestra.
- Juzgas mejor de lo que generas. Así que, para trabajo nuevo, crea alternativas toscas y elige mirando.
- Tiendes a lo medio y a lo delgado. Por lo tanto, las páginas nuevas reciben una idea, un movimiento grande y un argumento completo.
1. Mira lo que existe
Antes de cualquier otra cosa, encuentra y declara en una línea:
- Plataforma: web, o una aplicación móvil (iOS, Android, ambas). Lee el proyecto; nunca asumas.
- Superficie: Persuadir (marketing, aterrizaje, escaparate), Operar (tablero, herramienta, administración, pantalla de app) o Leer (documentos, artículos).
- Sistema existente:
DESIGN.md, archivos de tema o tokens, componentes compartidos, dos o tres pantallas terminadas. - Lo que el usuario proporcionó: capturas de pantalla, enlaces, logotipos, colores de marca, fuentes, fotografías.
Implementa con el framework y las convenciones que el proyecto ya utiliza.
2. Toma la única ruta que encaja
Usa la primera fila que coincida. Lee solo los archivos que nombra.
| La tarea | Haz | Lee |
|---|---|---|
| Un ajuste: un componente, una corrección de espaciado o color | Haz el cambio y míralo. Sin preguntas, informe de una línea | Nada, o la parte de craft.md que toca |
Un comando con nombre (polish, audit, typeset, colorize, animate, simplify, variants) | Sigue el comando | references/commands/<nombre>.md y lo que nombra |
| "Revisa esto" o "critica esto" | Informa, no cambies nada | review.md, laws.md, verify.md |
| "Haz que esto se vea mejor", "se ve genérico", sobre algo que existe | Encuentra lo que realmente está mal, luego corrige dentro de la apariencia existente | extend.md sección 3, luego commands/polish.md; para una debilidad clara, el comando correspondiente |
| Nueva pantalla o componente en un proyecto que tiene una apariencia | Extiende. Sin trabajo de dirección, sin preguntas | extend.md; más product.md para superficies Operar, mobile.md para nativo |
| Nueva superficie Operar sin nada que coincida | Pregunta si el resumen está abierto, luego construye | ask.md, product.md, craft.md; mobile.md si es nativo |
| Nueva superficie Persuadir o Leer sin nada que coincida | Pregunta si el resumen está abierto, luego el flujo completo | ask.md, create.md (que incluye structures.md e ingredients.md), web.md o mobile.md; photos.md si las imágenes hacen la venta o se proporcionaron fotos |
| Un rediseño que el usuario solicitó explícitamente | Trátalo como trabajo nuevo, manteniendo el contenido y el comportamiento | La fila de trabajo nuevo correspondiente, más extend.md sección 1 para inventariar lo que debe sobrevivir |
Cada ruta que construye algo termina en el bucle de abajo, con slips.md y verify.md. Los ajustes solo necesitan una mirada.
Cambiar la identidad de un producto existente necesita una solicitud explícita. Sin ella, "haz que destaque" significa mejor trabajo dentro de la apariencia actual.
3. Pregunta (solo trabajo nuevo)
Cuando el resumen deja abierto para quién es, cómo debería sentirse o qué tiene que mostrar el usuario, pregunta antes de diseñar: una ronda, como máximo cuatro preguntas sobre el producto, cada una que se pueda omitir, ninguna sobre fuentes o colores. Para una página nueva, también pregunta en torno a qué debería construirse la primera pantalla (tres enfoques que propones para este tema) y cuántas direcciones quieren ver lado a lado (1, 3 o 5; se recomiendan 3). ask.md las tiene. Omite las preguntas que ya responde el resumen o DESIGN.md.
Si no hay nadie para responder, declara cada suposición y continúa. Nunca esperes en un bucle.
4. El bucle
- Construye la primera versión real.
- Mira. Renderízala y captúrala a 320, 390 y 1440 de ancho (para nativo, en un simulador o dispositivo del tamaño de un teléfono). Antes de volver a leer el código, escribe lo que es visible.
- Verifica con
slips.md. Ejecuta los scripts que correspondan (consultaverify.md). - Úsala. Presiona el botón principal, completa el formulario, navega con Tab, encuentra la navegación en ancho de teléfono.
- Corrige lo que encontraste y vuelve a mirar. Dos rondas, luego informa lo que queda.
Si no se puede renderizar nada, dilo, verifica la fuente en su lugar y no llames al trabajo verificado. Para trabajo sustancial (una página o pantalla completa) donde existan subagentes, entrega las capturas de pantalla a un revisor nuevo que no haya visto tu razonamiento; sus correcciones cuentan como una de las dos rondas.
Reglas que siempre se cumplen
- La palabra de quién gana: una instrucción explícita del usuario; luego el sistema existente; luego las respuestas y referencias del usuario; luego la dirección que escribiste; luego los números y listas de esta habilidad. Los mínimos de accesibilidad no se anulan por el gusto, tuyo o de esta habilidad. Algo que el usuario solicitó nunca se reporta como defecto.
- Contenido honesto. Sin lorem ipsum, y sin pruebas inventadas: testimonios, clientes, logotipos, calificaciones, números de uso. Los hechos que una página necesita (un precio, condiciones de prueba) pueden ser sustitutos plausibles, marcados en un comentario de código y listados en el informe. Los datos de muestra en una demostración, catálogo o tablero son bienvenidos cuando son específicos, y se etiquetan como muestra una vez en pantalla.
- El restyling nunca cambia el comportamiento. Mantén nombres de campos, ids, enlaces, manejadores, acciones de formulario, hooks de prueba y atributos de accesibilidad.
- Construye los estados que pueden ocurrir, y todos ellos. Presionado y deshabilitado siempre; hover y foco de teclado donde haya un puntero o un teclado. Cargando, vacío y error donde algo real cargue, pueda estar vacío o pueda fallar. Nunca construyas una llamada de red solo para tener un estado de carga.
- Mínimos de accesibilidad: contraste de texto 4.5:1; foco de teclado visible; controles de al menos 24px, y 44pt / 48dp en pantallas táctiles; una ruta de movimiento reducido; nada se pierde cuando el texto se agranda.
craft.mdtiene los números ylaws.mdel estándar exacto. - Verificado significa mirado.
Informe
Encontrado: plataforma, superficie, sistema existente, lo que el usuario proporcionó
Dirección: una oración (trabajo nuevo), o qué se reutilizó y qué se agregó (extensión)
Mirado: qué se renderizó, a qué anchos, qué se usó a mano
Corregido: lo que atrapó el bucle
Asumido: hechos sustitutos y datos de muestra, por tipo, o "ninguno"
Abierto: qué no está hecho o no verificado, y cualquier cosa que una guía indique señalar
Mantén solo estas líneas. Un ajuste recibe una línea.
Archivos
| Archivo | Contiene |
|---|---|
ask.md | La ronda de preguntas |
create.md | Trabajo nuevo Persuadir y Leer: la idea, el movimiento grande, alternativas toscas, la dirección |
structures.md | Estructuras de página entre las que elegir, para que las alternativas difieran en forma y no solo en color |
ingredients.md | Los roles de token que cada dirección completa, y las opciones de color, tipo, forma y espacio |
extend.md | Trabajar dentro de una apariencia existente |
product.md | Superficies Operar: tableros, herramientas, pantallas de app |
photos.md | Páginas lideradas por fotografías |
web.md, mobile.md | Qué va dónde en una página web o una pantalla de teléfono |
slips.md | Errores realmente cometidos, por superficie. Se verifica en cada mirada |
verify.md | Cómo capturar, verificar y revisar; los scripts auxiliares |
craft.md | Cada número: tipo, color, espacio, movimiento, objetivos |
laws.md | Qué justifican y qué no las leyes de UX; mitos |
tells.md | Valores predeterminados comunes de diseño generado |
review.md, design-md.md | Formato de crítica; registro de decisiones |
Todos están en references/.
Cada ruta en esta habilidad (references/..., scripts/..., assets/...) es relativa a la carpeta que contiene este archivo, no al proyecto del usuario. En Claude Code, esa carpeta es ${CLAUDE_SKILL_DIR}. Al ejecutar un script, usa su ruta completa, por ejemplo node "<carpeta de esta habilidad>/scripts/lint.js" <objetivo>.