Construir un sitio para cliente
La sesión principal ejecuta este pipeline y delega en subagentes. (Los subagentes no pueden iniciar otros subagentes, por eso esto es una skill, no un agente orquestador).
[0 Puerta de intake] brief + DESIGN.md + referencias
↓
[1 Plan] mapa del sitio, secciones de página, copy → plan.md, src/data/*
↓
[PUERTA DE USUARIO 1] aprobar plan y copy
↓
[2 Construcción] páginas y sistema visual
↓
[3 SEO] agente seo → seo-report.md
↓
[4 Verificar] npm run verify (puerta dura)
↓
[5 Revisión] agente site-reviewer → review-report.md
↓
[6 Bucle de corrección] P0/P1 → corregir → verificar → re-revisar (máx. 2 rondas)
↓
[PUERTA DE USUARIO 2] aprobar el sitio
↓
[7 Preparación de lanzamiento] lista de verificación de lanzamiento + documento de entrega
↓
[8 Lecciones] añadir a docs/lessons.md
Artefactos
Todo va en .claude/pipeline/:
pipeline-state.md etapa, ronda de corrección, última actualización
plan.md mapa del sitio, secciones por página, acción principal por página
review-report.md de site-reviewer
seo-report.md de seo
screenshots/ de npm run verify
Lee pipeline-state.md al inicio de cada etapa y reanuda desde donde indica. Actualízalo al final de cada etapa. Esto permite que una construcción abarque varias sesiones.
Etapa 0: Puerta de intake
Verifica cada elemento. Si falta alguno, detente y ayuda al usuario a completarlo antes de cualquier otra cosa.
| Elemento | Listo cuando |
|---|---|
.agents/product-marketing.md | La sección de datos comerciales está completa, la acción principal nombrada, la audiencia y la voz completas. Usa la skill product-marketing para redactarlo a partir de lo que te dé el usuario. |
src/data/business.json | Nombre, teléfono, dirección, horario, enlace al mapa coinciden con el brief. Cópialos del brief. |
DESIGN.md | Cada sección está completa. Si el usuario solo tiene referencias, redáctalo a partir de references/ y pídele que lo confirme. |
references/ | Al menos dos capturas de pantalla o URLs con una línea sobre qué tomar de cada una. |
| Recursos del cliente | Logotipo y fotos, o una nota explícita de que los sustitutos están bien por ahora. |
| Edición | ¿Editará el cliente el sitio por sí mismo? (Afecta a la etapa 7). |
Luego completa src/styles/tokens.css a partir de DESIGN.md.
Etapa 1: Plan
- Escribe
plan.md: las páginas (la mayoría de los clientes necesitan Inicio, una página por oferta principal o una página de Menú/Servicios, Acerca de, Contacto), la acción principal por página y las secciones de cada página en orden. Usa el brief ysite-essentials. - Escribe el copy con la skill
copywriting, luego ejecutacopy-editingsobre él. Parte del lenguaje del cliente en el brief y de las propias palabras del cliente, y usa algunas de esas frases casi textualmente. Sigue la regla interna 9 en CLAUDE.md (sin frases genéricas de IA). Ponlo ensrc/data/(home.json, services, FAQs), no en componentes. - Marca cualquier cosa que no sepas como
[NEED: ...]. Nunca rellenes un vacío con un dato inventado.
Puerta de usuario 1
Detente. Muestra al usuario: el mapa del sitio, las secciones y la acción principal de cada página, el copy completo y cada elemento [NEED: ...]. Espera la aprobación o cambios. El copy es más barato de cambiar ahora que después de la construcción.
Etapa 2: Construcción
Construye con la skill design-taste-frontend (Taste Skill), dentro de este proyecto Astro. Antes de empezar, indícale:
- El tipo es
place(la gente va a él) oservice(se contrata a personas), nunca un tipo tecnológico. - DESIGN.md y
references/establecen la paleta, la tipografía y la sensación. Su propia paleta y fuentes predeterminadas quedan anuladas. - Los datos comerciales provienen de
src/data/business.json. Sus reglas de contacto predeterminadas no aplican. - El movimiento sigue las reglas internas en CLAUDE.md.
Construye página por página, comenzando por Inicio. Después de Inicio, ejecuta npm run verify, mira las tres capturas de pantalla y corrige lo que veas antes de construir la siguiente página. La puerta de finalización de Taste Skill se ejecuta por sí sola cuando se detiene; trata sus hallazgos como entrada, pero CLAUDE.md prevalece en caso de conflictos.
Etapa 3: SEO
El agente SEO edita las etiquetas head, JSON-LD y robots, por lo que se ejecuta antes de la verificación y la revisión. Así la revisión juzga el sitio terminado.
seo: "Auditar e implementar SEO para este sitio, incluyendo el paso de negocio local. Brief: .agents/product-marketing.md. Escribe tu informe en .claude/pipeline/seo-report.md."
Etapa 4: Verificar (puerta dura)
npm run verify
Todos los FALLOS de check-site y los problemas de capturas de pantalla (desplazamiento lateral, errores de consola) deben corregirse antes de la revisión. Los fallos [NEED: ...] solo están permitidos para datos que ya se le han pedido al usuario; enuméralos. Reescribe cualquier copy que check-site marque como genérico, a menos que el cliente realmente use esa palabra.
Etapa 5: Revisión
El revisor es de solo lectura y devuelve su informe como su mensaje final. Guarda ese mensaje textualmente en .claude/pipeline/review-report.md.
site-reviewer: "Revisa el sitio construido. Plan: .claude/pipeline/plan.md. Brief: .agents/product-marketing.md. Diseño: DESIGN.md. Capturas de pantalla: .claude/pipeline/screenshots/. Cambios SEO ya realizados: .claude/pipeline/seo-report.md. Devuelve el informe completo como tu mensaje final."
Etapa 6: Bucle de corrección
| Veredicto de site-reviewer | Acción |
|---|---|
| Listo | Ir a la puerta 2 |
| Requiere seguimiento, solo P2 | Ir a la puerta 2, listar los P2 |
| Requiere seguimiento (P1) o Bloqueado (P0) | Ronda < 2: corregirlos, volver a ejecutar la etapa 4 (verificar), volver a ejecutar site-reviewer en las páginas cambiadas y guardar su informe. Ronda = 2: detenerse y mostrar al usuario. |
Usa el agente bug-fixer para cualquier cosa que esté rota en lugar de simplemente fuera del brief. Incrementa la ronda en pipeline-state.md cada vez.
Puerta de usuario 2
Detente. Muestra al usuario: capturas de pantalla de Inicio a 390 y 1440, el veredicto, los P2 restantes, decisiones de SEO necesarias, elementos [NEED: ...] restantes y fotos provisionales a reemplazar. Espera la aprobación.
Etapa 7: Preparación para lanzamiento
- Ejecuta
npm run check:launchy corrige cada FALLO. Luego completadocs/launch-checklist.md, marcando cada elemento como hecho, no aplicable, o esperando a alguien (indica quién). - Completa
docs/handoff.mdpara el cliente. - Si el cliente va a editar el sitio, sigue
docs/client-editing.md. - Después de que el sitio esté en vivo en su dominio real, recuerda al usuario que ejecute claude-seo en él:
/seo local <url>y/seo audit <url>.
Etapa 8: Lecciones
Escanea los informes y las rondas de corrección en busca de cualquier cosa que haya salido mal dos veces o que haya costado tiempo real. Añade una línea con fecha por lección a docs/lessons.md. Indica al usuario qué lecciones vale la pena copiar de vuelta a site-starter para que todos los sitios futuros las reciban.