Ciclo de vida del workflow
La secuencia prevista de skills, el gate de preparación que protege la implementación y las reglas que hacen seguro el trabajo en paralelo.
Mapa del ciclo de vida
Contexto y diseño
Capturar el brief, auditar las referencias y fijar la base visual.
0-project-context-setup
Registra objetivos, restricciones, decisiones y referencias.
1-figma-pdf-audit
Documenta lo que los diseños suministrados realmente muestran.
2-brand-foundation
Define tokens, tipografía, roles de color y reglas responsive.
Arquitectura y planificación
Dividir el diseño aprobado en paquetes de trabajo ejecutables.
3-component-architecture-planner
Emite la arquitectura, el grafo de dependencias y el índice de paquetes.
En este punto la skill opcional task-backlog-generator puede copiar los paquetes a un backlog.
Gate de preparaciónGate
La implementación no empieza hasta verificar que todo está listo.
3.1-workflow-readiness-validator
Comprueba que el contexto y los artefactos de planificación estén completos.
Veredictos posibles
- READY
- READY WITH CONDITIONS
- NOT READY
Con NOT READY o condiciones sin cumplir, hay que resolver las brechas y volver a ejecutar el validador antes de implementar.
Implementación
Los paquetes de trabajo aprobados se ejecutan, potencialmente en paralelo.
3.2-work-package-orchestrator
Convierte el plan de paquetes en un runbook de ejecución con olas y prompts por lote.
4-shared-shell-builder
Construye layouts, navegación y el shell transversal.
5-astro-react-component-builder
Construye componentes reutilizables según los contratos.
6-page-implementation
Compone páginas a partir del shell y los componentes.
Los paquetes corren en paralelo solo cuando las dependencias están cumplidas y la propiedad de archivos no se solapa.
Auditorías de calidad
Auditorías independientes que producen hallazgos, no arreglos silenciosos.
7-asset-content-audit
Comprueba assets y contenido contra el alcance aprobado.
8-accessibility-performance-audit
Comprueba accesibilidad, responsive y Core Web Vitals.
9-seo-audit
Comprueba metadatos, indexabilidad y datos estructurados.
Validación de publicación
La evidencia se consolida en un veredicto para una decisión humana.
10-website-release-validator
Reporta la preparación. No despliega.
Fuera del mapa de fases
Opcionaltask-backlog-generator
Paso 3.3. Copia los paquetes de trabajo a un backlog. Nunca un prerrequisito de la implementación.
Auxiliarproject-readme-generator
Documenta el repositorio real. Puede ejecutarse de forma independiente en cualquier momento.
Auxiliardesign-taste-frontend
Guía de diseño consultiva. No sobreescribe los requisitos del proyecto.
El gate de preparación
La implementación no empieza con buenas intenciones. El validador de preparación comprueba que el contexto, el alcance, las referencias y los artefactos de arquitectura estén completos, y reporta uno de tres veredictos.
- READYEl contexto y los artefactos de planificación están completos. La implementación puede empezar.
- READY WITH CONDITIONSLa implementación puede empezar una vez que las condiciones documentadas se atiendan y queden registradas.
- NOT READYExisten brechas bloqueantes. Hay que resolverlas y volver a ejecutar el validador antes de implementar.
Estos son los veredictos que el validador puede producir, no un estado de este repositorio. Aquí no se ha ejecutado ninguna validación.
Etapa por etapa
- 0
0-project-context-setup
Capturar los objetivos, restricciones, decisiones existentes y referencias disponibles del proyecto antes de cualquier trabajo de diseño o implementación.
- 1
1-figma-pdf-audit
Analizar las referencias de diseño suministradas y documentar la estructura de páginas, patrones visuales, componentes reutilizables, inferencias responsive y preguntas abiertas.
- 2
2-brand-foundation
Convertir el contexto aprobado y la auditoría de diseño en un sistema visual documentado: tokens, escalas de espaciado, tipografía, roles de color y reglas responsive.
- 3
3-component-architecture-planner
Producir una arquitectura de componentes lista para implementar y dividirla en paquetes de trabajo con conflictos minimizados para agentes en paralelo.
- 3.1
3.1-workflow-readiness-validator
Auditar si el contexto, el alcance, las referencias y la arquitectura son suficientes para empezar la implementación. Reporta la preparación sin cambiar archivos.
- 3.2
3.2-work-package-orchestrator
Convertir el plan de paquetes de trabajo aprobado en un runbook de ejecución: mapea cada paquete a su skill, determina olas de ejecución paralela seguras y genera prompts por lote listos para pegar.
- 3.3Opcional
task-backlog-generator
Convertir los paquetes de trabajo aprobados en un backlog neutral en Markdown que se puede copiar a cualquier herramienta de gestión de tareas.
- 4
4-shared-shell-builder
Implementar el shell compartido aprobado del sitio: layouts, marco global, navegación, footer y otros elementos transversales.
- 5
5-astro-react-component-builder
Implementar los componentes UI reutilizables aprobados, manteniendo la arquitectura Astro-first y usando React solo donde la interacción o el estado lo justifican.
- 6
6-page-implementation
Componer páginas y secciones específicas a partir del shell compartido y los componentes disponibles, siguiendo referencias y alcance aprobados.
- 7
7-asset-content-audit
Auditar assets y contenido contra el alcance aprobado y las referencias de diseño. Reporta recursos faltantes, incorrectos, sin usar o sin optimizar sin reemplazarlos en silencio.
- 8
8-accessibility-performance-audit
Evaluar accesibilidad, comportamiento responsive, rendimiento en runtime y Core Web Vitals usando la evidencia y las comprobaciones disponibles del proyecto.
- 9
9-seo-audit
Auditar el SEO técnico y on-page del sitio implementado: metadatos, canonicalización, indexabilidad, datos estructurados, sitemap y enlazado interno.
- 10
10-website-release-validator
Consolidar alcance, estado de paquetes, comprobaciones y hallazgos de auditoría en un veredicto de publicación. No despliega ni declara éxito por sí mismo.
Las skills auxiliares project-readme-generator y design-taste-frontend pueden ejecutarse en cualquier momento y no son etapas de esta secuencia.
Reglas que siempre aplican
Paquetes de trabajo vs skills
Los paquetes de trabajo definen qué hacer. Las skills definen cómo se ejecuta una clase de trabajo.
Las auditorías reportan, no arreglan
Las skills de auditoría devuelven hallazgos y evidencia. Los cambios ocurren mediante arreglos y re-ejecuciones.
El validador consolida
El validador de publicación reúne evidencia para una decisión. No despliega.
Lo opcional sigue siendo opcional
El generador de backlog y las skills auxiliares nunca son prerrequisitos ocultos.