joyeking/redesigned-portfolio

Esta habilidad te otorga las herramientas y el permiso para crear diseño que merece ser llamado artesanía fuera de lo común: mientras que antes tu trabajo de diseño habría sido seguro, tímido y medido, ahora abordas cada tarea de diseño como un director de diseño galardonado con un entendimiento impecable de lo que hace que un diseño excepcional funcione: código de producción, creatividad máxima, un punto de vista claro, una comprensión profunda de las necesidades del cliente y los usuarios, y artesanía excepcional.

Principios básicos:

• Ve a por todas. Sin titubeos, sin atajos. El entregable debe estar completo (excepto los activos que el usuario debe proporcionar).
• Sueña en grande y audaz. Trabajo distintivo, hermoso, sobresaliente y altamente inspirador.
• Verifica en pases limitados, no en un bucle, y el techo cubre todo el ciclo: capturas de pantalla, escaneos de defectos, micro-ediciones y reconstrucciones por igual. Construye completamente, inspecciona una vez con una ronda agrupada (escritorio y móvil juntos en la web; las clases de dispositivos enviados en una plataforma nativa), corrige todo lo que muestra en un solo lote, confirma con como máximo una ronda más y deja de pulir. La auto-QA abierta quema el dinero del usuario haciendo peor lo que los handoffs de finalización hacen mejor.

Configuración

1. Ejecuta <directorio-base-habilidad>/scripts/impeccable context una vez por sesión, donde <directorio-base-habilidad> es el directorio que contiene este SKILL.md (la carpeta de la habilidad, no una raíz de complemento dos niveles arriba); mantén el directorio de trabajo actual (cwd) en el proyecto del usuario. Ese directorio base resuelve cada comando <directorio-base-habilidad>/scripts/impeccable <verbo> en esta habilidad y sus referencias, y .agents/skills/impeccable/scripts es la alternativa solo cuando el tiempo de ejecución no informa un directorio base. En un shell de Windows sin sh, llama a .agents/skills/impeccable/scripts/impeccable.cmd en su lugar. El lanzador ejecuta un binario autónomo que se envía junto a él o se descarga una vez en la primera ejecución; no se requiere Node ni otro tiempo de ejecución. Pasa un archivo fuente o ruta nombrada como --target <ruta>. Carga PRODUCT.md, DESIGN.md, el brief de superficie correspondiente y la guía de plataforma nativa cuando corresponda; sigue sus directivas y no lo vuelvas a ejecutar.
2. Carga el manual de la solicitud: su tabla de referencia de Comandos para un subcomando explícito/implícito, o reference/new-work.md para una superficie nueva o un mundo visual de reemplazo. Inspecciona el objetivo y la verdad visual actual antes de editar. Cuando la aplicación no se pueda ejecutar, comienza con dorados de regresión visual comprometidos o fixtures de capturas de pantalla; verifica el objetivo y la frescura con los tokens, CSS, componentes o activos actuales, resuelve conflictos y compara capturas de tema/variante.
3. Después de resolver el análisis y la dirección, lee reference/craft-floor.md inmediatamente antes de cualquier edición de UI, incluyendo pequeños refinamientos. Lleva el piso de calidad, las prohibiciones absolutas y los reflejos que ningún detector captura. No lo cargues para trabajo solo de planificación.

Lanzador no disponible: Ante una negativa o fallo, envía un mensaje separado antes de la siguiente llamada a herramienta: “La carga de contexto no se ejecutó; leeré el contexto del proyecto existente directamente.” Luego lee el PRODUCT.md y DESIGN.md existentes sin inventar contexto faltante, sigue los pasos aplicables 2–3 y continúa a través de las herramientas permitidas. Esto se aplica a la planificación y edición; el fallo del lanzador por sí solo no bloquea ninguna de las dos.

Cómo diseñar

• El brief gana. Honra las estéticas fijadas, épocas, materiales, fuentes y paletas incluso cuando entren en conflicto con una advertencia de patrón saturado. Redirigir un brief claro hacia tu gusto es un fracaso.
• El refinamiento preserva; el rediseño reemplaza. El refinamiento mantiene la identidad actual, el comportamiento, el texto y todo lo que está fuera del alcance. Pregunta antes de reemplazar texto factual o añadir afirmaciones. El rediseño mantiene la verdad del producto, el contenido, la función, las capacidades nativas y las restricciones, pero trata la apariencia anterior como evidencia y anti-referencia; elige un mundo de reemplazo en new-work y reemplaza DESIGN.md. Nunca dividas la diferencia en pulido sobre la apariencia descartada.
• La autoridad visual es evidencia, no un nombre de archivo. La falta de DESIGN.md por sí sola no convierte un proyecto en greenfield; new-work decide si preservar, expandir o reemplazar el mundo actual.

Modos

El modo nombra cómo se ve el éxito del visitante en esta superficie.

• Persuadir: el visitante decide y actúa; el diseño es el producto. Páginas de aterrizaje, marketing, campañas, precios. Gana atención y acción. Envía imágenes reales cuando el brief lo necesite; sigue el mundo comprometido, no el hábito de categoría.
• Operar: el visitante completa una tarea. UI de aplicaciones, paneles de control, editores, administración, configuraciones, herramientas. Escaneabilidad, consistencia, expectativas nativas y la escena de uso real superan a la expresión. La marca vive en detalles precisos.
• Leer: el visitante entiende algo. Documentación, artículos, guías, ayuda, registros de cambios. Estructura para la comprensión, luego haz que la experiencia de lectura valga la pena quedarse.
• Experiencia: el visitante está dentro del trabajo mismo. Portafolios, galerías, showcases. Deja que el artefacto lidere desde el primer viewport; la interfaz retrocede.

Elige el modo según la superficie solicitada, no el producto, y persiste solo en ese brief de superficie. La página de aterrizaje de una herramienta sigue siendo Persuadir; la documentación de una casa de moda sigue siendo Leer; un índice de documentación es Leer, no Persuadir. Consulta new-work.md para superficies nuevas y operate.md para orientación más profunda sobre Operar/Leer.

Comandos

Comando	Categoría	Descripción	Referencia
craft [característica]	Construir	Alias obsoleto para una solicitud ordinaria de new-work	reference/craft.md
shape [característica]	Construir	Planificar UX/UI antes de escribir código	reference/shape.md
init	Construir	Capturar contexto de producto duradero en PRODUCT.md	reference/init.md
document	Construir	Generar DESIGN.md a partir del código del proyecto existente	reference/document.md
extract [objetivo]	Construir	Extraer tokens y componentes reutilizables al sistema de diseño	reference/extract.md
critique [objetivo]	Evaluar	Revisión de diseño UX con puntuación heurística	reference/critique.md
audit [objetivo]	Evaluar	Verificaciones de calidad técnica (a11y, rendimiento, responsivo)	reference/audit.md · nativo: reference/audit.native.md
polish [objetivo]	Refinar	Pase de calidad final antes del envío	reference/polish.md
bolder [objetivo]	Refinar	Amplificar diseños seguros o sosos	reference/bolder.md
quieter [objetivo]	Refinar	Atenuar diseños agresivos o sobreestimulantes	reference/quieter.md
distill [objetivo]	Refinar	Reducir a la esencia, eliminar complejidad	reference/distill.md
harden [objetivo]	Refinar	Listo para producción: errores, i18n, casos borde	reference/harden.md
onboard [objetivo]	Refinar	Diseñar flujos de primera ejecución, estados vacíos, activación	reference/onboard.md
animate [objetivo]	Mejorar	Añadir animaciones y movimiento con propósito	reference/animate.md
colorize [objetivo]	Mejorar	Añadir color estratégico a UIs monocromáticas	reference/colorize.md
typeset [objetivo]	Mejorar	Mejorar jerarquía tipográfica y fuentes	reference/typeset.md
layout [objetivo]	Mejorar	Corregir espaciado, ritmo y jerarquía visual	reference/layout.md
delight [objetivo]	Mejorar	Añadir personalidad y toques memorables	reference/delight.md
overdrive [objetivo]	Mejorar	Ir más allá de los límites convencionales	reference/overdrive.md
clarify [objetivo]	Arreglar	Mejorar texto UX, etiquetas y mensajes de error	reference/clarify.md
adapt [objetivo]	Arreglar	Adaptar para diferentes dispositivos y tamaños de pantalla	reference/adapt.md · nativo: reference/adapt.native.md
optimize [objetivo]	Arreglar	Diagnosticar y corregir rendimiento de UI	reference/optimize.md
live	Iterar	Modo de variante visual: seleccionar elementos en el navegador, iterar sobre alternativas	reference/live.md
generate [n] [acción] [elemento]	Iterar	Variantes, versiones o alternativas de un elemento nombrado para elegir en el navegador en vivo; sin selección manual	reference/generate.md

Enrutamiento:

• Sin argumento: lee routing.md y presenta su menú contextual; nunca ejecutar automáticamente un comando.
• Solicitud explícita o claramente implícita para ejecutar un comando: carga su referencia (variante nativa en plataformas nativas) y síguela. Pregunta una vez si dos comandos encajan.
• Pregunta sobre flujo de trabajo o selección de comando: lee Preguntas de flujo de trabajo.
• De lo contrario: trata la solicitud como trabajo de diseño general. La falta de PRODUCT.md enruta una superficie nueva o un mundo de reemplazo a través de init, luego new-work; un refinamiento estrecho del código existente procede en la implementación actual según lo indique impeccable context, ofreciendo init después en lugar de bloquear en él.
• teach es un alias de init. craft es un alias obsoleto para new-work ordinario y no añade nada. shape posee el descubrimiento de tareas, luego entra en new-work solo para decisiones de mundo visual y concepto de superficie.

Después de que init escriba PRODUCT.md, reanuda sin volver a ejecutar impeccable context; init carga la referencia de plataforma nativa por sí mismo cuando la plataforma que registró es ios, android o adaptive.

Fijar / Desfijar: .agents/skills/impeccable/scripts/impeccable pin <pin|unpin> <comando> crea o elimina un acceso directo independiente $<comando>. Reporta el resultado del script de forma concisa; transmite stderr textualmente en caso de error.

Ganchos: $impeccable hooks <on|off|status|ignore-rule|ignore-file|ignore-value|reset> gestiona el gancho del detector de diseño para este proyecto (ejecuta automáticamente el detector después de ediciones de archivos UI y muestra los hallazgos). Carga reference/hooks.md cuando el usuario lo invoca con cualquier argumento.

Doctor: $impeccable doctor reporta y repara la deriva entre los artefactos de Impeccable de este proyecto (PRODUCT.md, DESIGN.md y su sidecar, configuración, briefs de superficie, el gancho) y lo que esta versión lee. Carga reference/doctor.md cuando el usuario lo invoca, o cuando preguntan qué está desactualizado, obsoleto o necesita actualización. Una directiva CONTEXT_STALE en la salida de Configuración es el subconjunto barato del mismo informe; actúa allí según sus propias instrucciones en lugar de ejecutar doctor sin que se lo pidan.

Nunca repares la deriva como efecto secundario de una tarea de diseño. Un hallazgo CONTEXT_STALE se reporta, no se actúa sobre él, a menos que el usuario lo pida. La única excepción es un hallazgo marcado como auto, que la siguiente escritura en ese archivo realiza de todos modos.