Communitygithub.com

Crear frontend desde cero

Crea un nuevo frontend desde un proyecto vacío o una nueva interfaz solicitada explícitamente, partiendo del resumen del producto y la audiencia hasta el diseño de interacción, la implementación y la verificación renderizada.

¿Qué es Crear frontend desde cero?

Esta skill está diseñada para construir un frontend completamente nuevo (como una landing page, tienda, dashboard o aplicación) desde una necesidad de producto. El flujo comienza comprendiendo el contexto del proyecto, definiendo una propuesta concreta de jornada y estados, y planificando la construcción reutilizando frameworks y componentes existentes o eligiendo la stack más simple. Durante la implementación se construyen contenido semántico, estilos, componentes e interacciones reales, evitando botones o enlaces falsos. La verificación incluye ejecutar la interfaz localmente, revisar tareas principales, navegación, accesibilidad (teclado, foco, contraste) y estados relevantes. Finalmente, se entrega un reporte con archivos modificados, decisiones, resultados de verificación y limitaciones, registrando la ejecución en `execution-record.json`. La skill es útil cuando se necesita partir de cero, pero no para auditar interfaces existentes (usar `audit-frontend-designer-konvert`) ni para aplicar referencias o refinar interfaces existentes (usar `design-por-referencia-konvert`). Las plataformas soportadas incluyen proyectos en Node.js, React, Vue, etc., con énfasis en contenido sintético y privacidad de datos.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/andreischuaste12-ctrl/frontend-designer-konvert/tree/main/skills/create-frontend-from-zero-konvert

Preguntar en tu IA favorita

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

Documentación

¿Qué hace Crear frontend desde cero?

Transforma una necesidad de producto en una interfaz funcional, accesible y verificable. Esta skill lidera cuando el objetivo principal es construir un frontend nuevo, en proyecto vacío o en un área nueva explícitamente solicitada. Implementa, ejecuta el proyecto cuando sea viable y reporta lo que realmente verificó.

Fronteras y colaboración

  • Nuevo frontend: esta skill lidera, incluso cuando una referencia ayuda a orientar una creación original. Extrae principios, sin copiar marca, contenido o activos de terceros.
  • Auditar interfaz existente: usa audit-frontend-designer-konvert, que es solo lectura. Para "auditar y corregir", comienza por ella y sigue el contrato de aprobación.
  • Aplicar referencia, refinar directamente una interfaz existente o implementar informe aprobado: usa design-por-referencia-konvert y respeta sus reglas de alcance, aprobación y dependencia externa.
  • En proyectos mixtos, implementa solo el área nueva autorizada; identifica y preserva integraciones e interfaces existentes. Consulta la guía de colaboración para aprovechar el conocimiento y las herramientas de las otras skills sin duplicarlos.

Flujo

  1. Entender la solicitud y el contexto. Lee instrucciones del proyecto, archivos relevantes, stack y convenciones existentes. Identifica producto, audiencia, tarea principal, páginas, datos, identidad, restricciones y dónde se entregará el trabajo. Distingue hechos proporcionados de hipótesis; no inventes personas ni resultados de investigación. Si una elección indispensable no puede inferirse y tiene impacto irreversible, pide aclaración; en las demás decisiones, declara la suposición y avanza. Registra el resultado en el brief de descubrimiento y brief.
  2. Definir una propuesta concreta. Elige el journey y los estados relevantes: inicial, carga, vacío, éxito, error y recuperación cuando corresponda. Lista componentes y estados por pantalla con estados y componentes, usando las unidades de la auditoría como criterio de finalización. Para proyectos con múltiples páginas o categorías, define caminos con estructura de contenido y navegación. Define contenido, jerarquía, navegación y dirección visual coherentes con la audiencia y el objetivo, con tokens decididos según la fundación visual. Usa la exploración de dirección visual cuando dos opciones cambien materialmente el resultado. Usa los materiales locales existentes y, si están disponibles y son pertinentes, los catálogos y unidades de conocimiento de la auditoría. Cita solo referencias realmente consultadas. Una referencia visual es inspiración, no evidencia de usabilidad.
  3. Planificar la construcción. Reutiliza framework, routing, componentes y tokens existentes. En un proyecto vacío, elige la solución más simple adecuada a la solicitud y al entorno con la elección de stack; justifica dependencias nuevas, verifica versiones y scripts antes de ejecutarlos. No supongas autorización para servicios de pago, publicación, cuentas externas o datos reales. Mantén el alcance de backend, autenticación e integraciones según la solicitud; cuando falten, usa datos sintéticos e indica claramente la limitación.
  4. Implementar. Construye contenido, estructura semántica, estilos, componentes e interacciones reales dentro del alcance autorizado. Evita botones sin comportamiento o enlaces ficticios presentados como funcionales: implementa la acción solicitada o indica claramente su indisponibilidad. Usa tokens coherentes, estados visibles y layouts responsivos. Aplica las reglas de contenido, SEO, rendimiento y medición: contenido ficticio identificado, SEO básico en páginas públicas y ningún analytics sin solicitud. Consulta seguridad y localización para proteger el frontend y, cuando el producto tenga múltiples idiomas o regiones, adaptar la interfaz a los locales definidos. No elimines ni reemplaces código, datos, integraciones o archivos del usuario sin necesidad y autorización aplicable.
  5. Verificar. Ejecuta las verificaciones pertinentes al proyecto, ejecuta la interfaz localmente cuando sea posible y abre el resultado renderizado. Verifica tareas principales, contenido, navegación, teclado, foco, formularios, estados pertinentes, pantalla estrecha y escritorio; evalúa contraste y movimiento reducido cuando corresponda. Usa los scripts de la skill de referencia cuando estén disponibles, con salida autorizada y datos sintéticos. Para una creación sin versión anterior, no inventes un antes/después: registra la primera captura como referencia inicial y compara solo estados o versiones realmente existentes. Consulta verificación.
  6. Entregar y reportar. Revisa la definición de finalización y usa el modelo de informe de la misma. Informa archivos modificados, decisiones y suposiciones relevantes, cómo ejecutar, verificaciones realizadas y sus resultados, funcionalidades simuladas y lo que no se pudo validar. Registra tareas, áreas inspeccionadas, decisiones y criterios verificados en execution-record.json en el directorio de salida autorizado, siguiendo registro de ejecución y su validador. No almacenes prompt ni URLs privadas. No alegues pruebas con usuarios, conformidad integral, rendimiento o resultados comerciales sin evidencia. Si el navegador no está disponible, reporta explícitamente que la interfaz no fue inspeccionada visualmente.

Privacidad y seguridad

Usa solo objetivos y entornos autorizados. Nunca leas ni expongas .env, credenciales, sesiones o datos personales innecesarios; usa contenido sintético y revisa capturas antes de compartir. Respeta las protecciones y limitaciones de la herramienta de captura: la inspección ejecuta JavaScript y no es sandbox para sitios no confiables. Graba artefactos solo en directorio autorizado e ignorado por Git, o fuera del checkout; no alteres la configuración de privacidad del proyecto sin necesidad. No envíes datos a terceros, no crees cuentas ni publiques sin autorización.

Criterios de calidad

La interfaz debe sostener la tarea principal con claridad, jerarquía visual, contenido coherente y feedback útil. Cuida la semántica, el foco, los nombres accesibles, las etiquetas y el reflow según el contexto; no afirmes certificación de accesibilidad solo con verificaciones automáticas. No inventes métricas de conversión, testimonios, sellos, precios, integraciones o funcionalidades. Prefiere una implementación completa y testeable en el alcance a una apariencia convincente con acciones rotas.

Definición de finalización

La entrega solo está lista cuando la tarea principal funciona de punta a punta en el alcance acordado y cada elemento de la definición de finalización está cumplido, no aplicable con motivo o no verificado con motivo. Puntos que más fallan en creaciones desde cero:

  • estados además del normal (cargando, error, vacío, éxito y recuperación) sin forma de ser observados;
  • foco eliminado o cubierto, etiqueta solo en el placeholder y error indicado solo por color;
  • contraste y objetivos táctiles no medidos en el render;
  • botones y enlaces que parecen funcionar pero no hacen nada;
  • datos comerciales, testimonios o integraciones inventados;
  • analytics o fuentes externas añadidos sin decisión registrada.

Referencias y ejemplos

MaterialCuándo usarlo
Descubrimiento y briefAntes de construir: preguntas con patrones y registro de suposiciones.
Elección de stackProyecto vacío, sin plataforma definida.
Fundación visualTokens y restricciones verificables de contraste, objetivo y foco.
Exploración de dirección visualDirección original, opciones materiales y verificación en el render.
Estructura de contenido y navegaciónCaminos, etiquetas y organización de páginas en proyectos nuevos.
Estados y componentesInventario por pantalla y unidades de la auditoría como criterio de finalización.
Contenido, SEO, rendimiento y mediciónPáginas públicas, formatos brasileños, Core Web Vitals y privacidad.
Seguridad y localizaciónContenido variable, recursos externos y, cuando corresponda, varios idiomas o regiones.
VerificaciónCómo ejecutar y registrar las verificaciones.
ColaboraciónCuándo usar la auditoría y la ejecutora.
Definición de finalización y entregaAntes de reportar la entrega.
Brief de landing, brief de e-commerce y informe de entregaEjemplos sintéticos del nivel de detalle esperado.

Skills relacionados