wp-kickoff

Etapa 1: Kickoff

Objetivo: una página de verdad sobre el negocio, y un proyecto vacío con cada archivo que el método espera. No se ha diseñado ni construido nada aún.

Pasos

1. ¿Ya existe un sitio en vivo? Si es así, trátalo como un negocio en funcionamiento, no como un dominio estacionado. Primero haz un inventario (references/discovery-brief.md, "Sitio existente"):
   • cada URL (desde sus sitemaps), formulario, paso de pago, entrada de blog y detalle de contacto;
   • sus datos de Search Console, si el propietario puede compartirlos;
   • qué genera ingresos hoy. La reconstrucción debe mantener todo funcionando. Realiza el crawling de manera educada: primero lee los Términos de Uso (robots.txt no es permiso) y deja 2 segundos o más entre solicitudes.
2. Brief de descubrimiento. Haz las preguntas en references/discovery-brief.md y escribe las respuestas en docs/BRIEF.md. Marca cada hecho con su fuente (propietario, documento, crawl). Si no sabes un hecho, escribe PENDIENTE-<quién>. Nunca adivines.
3. Stack. Comienza desde el valor predeterminado en references/stack.md. Cambia una capa solo por una razón que puedas indicar, y regístrala en DECISIONS.md.
4. Crear el proyecto con el scaffolder del kit (dos carpetas arriba de este skill):

   bash <kit>/bin/wp-site-new --name "Acme Tours" --slug acme-tours --prefix acme \
        --domain example.com --dir ~/sites/acme-tours --git
   

   • slug: minúsculas y guiones. Nombra el proyecto DDEV, las carpetas y los dominios de texto.
   • prefix: de 2 a 12 letras minúsculas o dígitos. Cada función, opción, tipo de entrada, meta clave, hook y nonce comienza con <prefix>_.
5. Llenar AGENTS.md:
   • qué es el sitio;
   • quién aprueba el diseño y el texto del cliente;
   • las decisiones bloqueadas;
   • reglas estrictas específicas de este negocio, como afirmaciones reguladas, licencias que mostrar o palabras que el propietario nunca quiere.
6. Remoto privado, configurado el día 1. El propietario crea un repositorio privado y hace push. Una vez que exista el sitio local (etapa 3), ejecuta scripts/backup.sh y mantén una copia en otra máquina.
7. Inventario de credenciales (docs/reference/CREDENTIALS_INVENTORY.md):
   • enumera cada cuenta (registrador, DNS, host, SMTP, analíticas, Search Console, pagos, CDN);
   • escribe dónde vive cada secreto;
   • solo nombres, nunca valores.
8. Marca el gate de Kickoff en SITE_STATUS.md con evidencia: la fecha de aprobación del brief, el SHA del primer commit, el nombre del remoto.

Gate

• docs/BRIEF.md aprobado por el propietario (fecha)
• Decisiones bloqueadas y reglas estrictas del negocio en AGENTS.md
• Proyecto creado y commiteado; existe remoto privado
• Inventario de credenciales iniciado (solo nombres)
• Reemplazando un sitio en vivo: inventario de URLs y características guardado en docs/data/legacy/ (o "n/a")

Errores que hemos cometido

• Tratar el "cambio" como un cambio de DNS mientras el sitio antiguo estaba recibiendo reservas de pago ese día.
• Los recuentos de reseñas de un sitio antiguo ("1,118 reseñas") resultaron ser inventados. No los heredes.
• Proxear el dominio a través de Cloudflare mientras el host antiguo limitaba la tasa por IP. El host veía solo las IPs de Cloudflare, por lo que los visitantes reales recibían errores 429. Verifica los límites del origen antes de activar el proxy.
• Confiar en las notas de otro agente que decían "resuelto". La corrección no estaba subida, no probada y nunca desplegada. Verifica lo real.
• Alguien pegó una clave API en un chat de agente. Rota cualquier clave que un agente haya visto.