umairmsm/wp-site

Sitio WordPress: de una carpeta vacía a producción

Este kit es un método más un proyecto inicial. Se aprendió en un sitio de reservas multilingüe en vivo por el que pagan clientes reales. Sigue las etapas en orden. Cada etapa termina con una puerta: abandona una etapa solo cuando su puerta sea verdadera y la evidencia esté documentada.

1. Encontrar dónde está el proyecto

1. Busca SITE_STATUS.md en la raíz del proyecto.
   • Si falta: el proyecto no ha comenzado. Usa wp-kickoff.
   • Si está presente: léelo. La etapa actual es la primera etapa con una puerta sin marcar.
2. Lee AGENTS.md (las reglas del proyecto), luego las líneas más recientes de SESSION_LOG.md y DECISIONS.md.
3. Informa al propietario en dos líneas: la etapa actual y el siguiente paso concreto.

2. Las etapas

#	Etapa	Habilidad	Puerta para salir (la evidencia va en SITE_STATUS.md)
1	Inicio	wp-kickoff	Brief aprobado por el propietario; decisiones bloqueadas documentadas; repositorio privado; credenciales listadas por nombre
2	Diseño	wp-design	Prototipo estático aprobado (capturas de pantalla + fecha); tokens configurados; fuentes autoalojadas
3	Construcción	wp-build	Sitio local funcionando; plugin principal + tema hijo activos; elementos reales renderizados mediante funciones principales; consultas guardadas antes de reenviar; pruebas de estructura en verde
4	Contenido	wp-content	Cada página pública tiene texto aprobado por el propietario y fotos reales; páginas legales existen; sin texto de IA no aprobado
5	SEO e idiomas	wp-seo	Pruebas de título, descripción, canónico, esquema y hreflang en verde; mapa de redirección de URLs antiguas; cada idioma adicional pasó su piloto
6	Calidad	wp-quality	Suite completa en verde; 0 violaciones de accesibilidad; presupuestos de rendimiento cumplidos en staging
7	Envío	wp-ship	Staging refleja producción; hardening aplicado; launch-auditor PASS; corte realizado; 7 días vigilados
8	Operación	wp-operate	Copias de seguridad automáticas con una copia fuera de la máquina; un simulacro de restauración realizado; rutinas de actualización y alerta escritas

• Entregar el trabajo de una etapa a un agente constructor (Antigravity, Codex, otro Claude): wp-task-file.
• Revisión antes de un merge: agente wp-rules-reviewer. Antes del lanzamiento: agente launch-auditor.

3. Reglas estrictas (cada etapa, cada agente)

1. Plugin primero. La lógica, datos, textos de políticas, formularios, esquema y SEO viven en el plugin must-use principal. El tema es el diseño. La piel es la apariencia. Un rediseño no debe perder una funcionalidad.
2. Sin cards, precios o slugs hardcodeados en las plantillas. Consulta el tipo de contenido y renderiza a través de la función de renderizado del núcleo, para que una edición en el CMS se muestre en todas partes.
3. Los leads se guardan primero. Los formularios envían a admin-post.php con un nonce. El sitio almacena el lead en su propia base de datos, luego lo reenvía. Sin claves API ni endpoints de terceros en la página.
4. Sin pruebas falsas. Nunca muestres calificaciones, conteos de reseñas o testimonios que nadie pueda probar. Los números de reseñas importados o "heredados" cuentan como falsos hasta que se prueben.
5. Fotos reales para cualquier lugar, habitación, producto o persona nombrados. Las imágenes de IA solo como escenas generales, nombradas ai-*, registradas, y nunca presentadas como "esta es tu habitación".
6. Los hechos provienen del propietario. Precios, políticas, inclusiones y datos de seguridad nunca se inventan. El texto de IA es un borrador hasta que el propietario lo apruebe. Desconocido = PENDIENTE-<quién>.
7. Ningún PHP escrito por IA a producción sin rama, prueba local, diff y un merge humano. Estándares de codificación de WordPress. Prefija todo.
8. Sin page builders. Sin llamadas a Google Fonts. Fuentes autoalojadas: un tribunal alemán ordenó indemnizaciones porque cargarlas desde Google filtró las direcciones IP de los visitantes.
9. Staging y local nunca se indexan y nunca envían correos electrónicos a clientes reales.
10. Las pruebas nunca se debilitan para obtener verde: nada de eliminar, saltar o tomar nuevas instantáneas. Renombrar una prueba necesita la aprobación del propietario.
11. Los despliegues pertenecen al propietario. Desde un commit, a través de scripts/deploy-safe.sh: ejecución en seco primero, copia de seguridad primero, la palabra live escrita por un humano.
12. La base de datos es contenido. Cámbiala solo a través de un archivo de cambio revisable y un script protegido con ejecución en seco. Haz respaldo antes de cada cambio en la base de datos.
13. Los secretos nunca entran en git, registros, prompts o la página. CREDENTIALS_INVENTORY.md lista nombres y dónde vive cada secreto, nunca sus valores.
14. Un propietario de esquema (normalmente el plugin de SEO). Nunca generes un Offer sin un precio.

4. Preguntar primero al propietario

• Instalar plugins, temas, herramientas o servicios de pago (page builders: nunca).
• Cualquier cambio en un precio, moneda, política, nombre de marca o logotipo. Publicar un nuevo idioma.
• Cualquier cosa que toque DNS, Cloudflare, hosting, staging o producción. Comandos destructivos de base de datos o archivos.
• Enviar código o contenido del cliente a una API de IA de terceros.

5. Cómo trabajar

• Una etapa a la vez, un pequeño paso a la vez. Haz commit después de cada paso significativo (Conventional Commits).
• Rama, prueba local, diff, luego el propietario hace merge. Los agentes nunca hacen push, merge, deploy o ssh a un servidor a menos que el propietario solicite esa acción exacta.
• Cada decisión va en DECISIONS.md (fecha, quién, por qué). Termina cada sesión con una línea en SESSION_LOG.md.
• "Hecho" significa verificado: abre la página, ejecuta la prueba, lee la respuesta del servidor. Nunca repitas el "resuelto" de otro agente sin verificarlo tú mismo.

6. Habilidades útiles de otros kits (si están instalados)

• agent-skills-kit: wordpress-modern, wp-plugin-development, wp-wpcli-and-ops, wp-performance para detalles de la API de WordPress.
• agent-loop-kit: supervised-build, agent-supervisor para bucles de construcción no supervisados con una puerta y un revisor.