wp-playground

Descripción general de la habilidad wp-playground

wp-playground es la habilidad para configurar y trabajar con instancias de WordPress Playground cuando necesitas un entorno desechable y reproducible en lugar de una pila local completa de WordPress. La habilidad wp-playground es ideal para desarrolladores de plugins y temas, testers de QA y desarrolladores backend que quieren reproducir incidencias, probar versiones o compartir una configuración que pueda ejecutarse en el navegador o mediante @wp-playground/cli.

Lo más importante es el trabajo que resuelve: poner en marcha un sitio de WordPress rápidamente, con el código correcto montado, la versión adecuada de WP/PHP seleccionada y suficiente control para depurar o empaquetar el resultado. No es una habilidad genérica de “escríbeme un prompt de WordPress”; es una guía wp-playground práctica para configuraciones controladas, blueprints, snapshots y pruebas aisladas.

Encaje ideal para flujos de trabajo desechables en WP

Usa wp-playground cuando necesites:

• levantar un sitio temporal de WordPress para validar un cambio en un plugin o tema,
• probar contra una versión concreta de WordPress o PHP,
• ejecutar un blueprint o generar un snapshot para compartir,
• depurar el comportamiento en aislamiento sin afectar producción ni una base de datos local.

Qué lo hace diferente

Sus diferenciadores más fuertes son el flujo de trabajo con CLI, el soporte para blueprints y el runtime efímero y predecible. wp-playground funciona especialmente bien cuando te importa más la repetibilidad que una interfaz pulida. También cuenta el hecho de que el entorno está basado en SQLite y WebAssembly, lo que cambia tanto el rendimiento como las limitaciones frente a una instalación tradicional en servidor.

Restricciones importantes que conviene conocer primero

Solo encaja si puedes trabajar dentro de un entorno desechable. No sirve para datos de producción, estado local de larga duración ni flujos que dependan de una pila WordPress convencional basada en MySQL. Para obtener los mejores resultados, trátalo como un banco de pruebas controlado y no como sustituto de tu entorno principal de desarrollo.

Cómo usar la habilidad wp-playground

Instala y abre los archivos fuente

Empieza con la ruta estándar wp-playground install para tu herramienta de directorio y luego lee los archivos fuente de la habilidad antes de pedirle trabajo. Los archivos clave de este repo son SKILL.md, references/blueprints.md, references/cli-commands.md y references/debugging.md. Esos archivos te dicen qué entradas espera la habilidad y qué flags de CLI importan de verdad.

Convierte un objetivo vago en un prompt útil

Un prompt débil dice: “Configura WordPress Playground para mi plugin.”
Un prompt más sólido dice: “Usa wp-playground para crear una instancia local desechable para el plugin en packages/my-plugin, monta automáticamente el proyecto, prueba contra WP 6.9 y PHP 8.3, y dime el comando CLI exacto junto con los ajustes de mount o blueprint que hagan falta.”

Para el uso de wp-playground, incluye:

• la ruta del proyecto,
• si quieres server, run-blueprint o build-snapshot,
• las versiones de WordPress y PHP,
• si el código debe montarse automáticamente,
• si necesitas Xdebug o un archivo blueprint.

Elige primero el flujo de trabajo adecuado

Usa server --auto-mount cuando quieras una instancia interactiva para pruebas en vivo. Usa run-blueprint cuando necesites una configuración automatizada que arranque y termine. Usa build-snapshot cuando quieras un artefacto reutilizable que puedas entregar o volver a ejecutar más adelante. Si tu objetivo es depurar backend, indica el modo exacto de fallo y pide pasos compatibles con Xdebug en lugar de solicitar solo un comando de arranque.

Lee el repo en este orden

Una buena guía wp-playground empieza con SKILL.md, sigue con references/cli-commands.md para entender la forma de los comandos, después con references/blueprints.md si necesitas automatizar la configuración, y finalmente con references/debugging.md si la tarea implica breakpoints, mounts o ejecuciones atascadas. Este orden reduce la improvisación y evita que pases por alto flags como --mount-before-install o --blueprint-may-read-adjacent-files.

Preguntas frecuentes sobre la habilidad wp-playground

¿wp-playground es solo para demos de frontend?

No. La skill wp-playground es especialmente útil para desarrollo de plugins, temas y backend cuando necesitas comportamiento aislado de WordPress, versiones reproducibles o sesiones de depuración. Está menos orientada a demos visuales y más a la ejecución controlada.

¿Necesito primero una instalación local completa de WordPress?

Normalmente no. El objetivo de wp-playground install es darte un entorno rápido sin aprovisionar una pila tradicional. Si ya tienes una pila local, wp-playground sigue siendo útil cuando necesitas un punto de comparación limpio o una combinación específica de WP/PHP.

¿Cuándo no debería usarlo?

No lo uses para datos de producción, trabajo de contenido persistente o flujos que dependan de comportamientos específicos de MySQL. Si tu plugin depende de servicios externos, persistencia del sistema de archivos o estado de larga duración, wp-playground puede no ser la opción por defecto adecuada, salvo que puedas modelar explícitamente esas dependencias en un blueprint.

¿Es apto para principiantes?

Sí, si la tarea es sencilla y sigues de cerca los ejemplos de CLI. El principal punto de fallo es una entrada demasiado vaga: si no indicas la ruta del proyecto, los objetivos de versión o si necesitas un blueprint, el resultado será menos útil. Las personas principiantes obtienen mejores resultados cuando piden un solo flujo de trabajo claro cada vez.

Cómo mejorar la habilidad wp-playground

Dale a la habilidad las variables exactas de la configuración

La mayor mejora de calidad llega al especificar la raíz del proyecto, las versiones deseadas de WP/PHP y si el código debe montarse automáticamente o de forma explícita. Por ejemplo, “Usa wp-playground para probar plugins/contact-form contra WP 6.9 y PHP 8.3 con --auto-mount” es mucho mejor que “haz que funcione”.

Menciona el modo de fallo, no solo el objetivo

Si estás depurando, di qué está fallando: la instalación no termina, un hook del plugin no se ejecuta, una respuesta REST es incorrecta o un regression específico de versión solo aparece en PHP 8.3. Eso permite que la habilidad elija entre server, run-blueprint y build-snapshot, y mejora la utilidad de cualquier flujo de wp-playground for Backend Development.

Vigila los errores de mount y blueprint

Los problemas más comunes son rutas relativas de mount, archivos que deben existir antes de la instalación y blueprints que necesitan archivos locales adyacentes. Si la primera ejecución falla, mejora el prompt añadiendo rutas absolutas, confirmando si hace falta --mount-before-install y explicando si el blueprint lee recursos locales. Para depuración, pide detalles de configuración de Xdebug y el mapeo esperado del IDE.

Itera cambiando una sola variable cada vez

Si la primera salida se acerca pero no termina de encajar, cambia solo una cosa: la versión de WP, la versión de PHP, el modo de mount o el origen del blueprint. Así es más fácil identificar si el problema está en la elección del entorno, en los flags del comando o en la propia receta de configuración.