wp-playground

Visão geral do skill wp-playground

wp-playground é o skill para configurar e trabalhar com instâncias do WordPress Playground quando você precisa de um ambiente descartável e reproduzível, em vez de uma stack local completa de WordPress. O wp-playground skill é ideal para desenvolvedores de plugins e temas, testadores de QA e desenvolvedores de backend que querem reproduzir problemas, testar versões ou compartilhar uma configuração que possa ser executada no navegador ou via @wp-playground/cli.

O que mais importa é o problema que ele resolve: subir um site WordPress rapidamente, com o código certo montado, a versão certa de WP/PHP selecionada e controle suficiente para depurar ou empacotar o resultado. Não se trata de um skill genérico de “escreva um prompt de WordPress”; é um wp-playground guide prático para ambientes controlados, blueprints, snapshots e testes isolados.

Melhor opção para fluxos de trabalho descartáveis de WP

Use wp-playground quando você precisar:

• subir um site WordPress temporário para validar uma mudança em plugin ou tema,
• testar contra uma versão específica do WordPress ou do PHP,
• executar um blueprint ou gerar um snapshot para compartilhar,
• depurar o comportamento de forma isolada, sem afetar produção ou um banco de dados local.

O que o torna diferente

Os principais diferenciais são o fluxo via CLI, o suporte a blueprints e o runtime efêmero previsível. O wp-playground funciona muito bem quando você precisa mais de repetibilidade do que de uma interface polida. Também importa o fato de o ambiente usar SQLite e WebAssembly, o que muda tanto o desempenho quanto as restrições em comparação com uma instalação tradicional em servidor.

Restrições importantes para saber antes

Esse skill só faz sentido se você puder trabalhar dentro de um ambiente descartável. Ele não é para dados de produção, estado local de longa duração nem para fluxos que exigem uma stack WordPress convencional baseada em MySQL. Para melhores resultados, trate-o como um laboratório controlado, e não como substituto do seu ambiente principal de desenvolvimento.

Como usar o skill wp-playground

Instale e abra os arquivos de origem

Comece pelo caminho padrão wp-playground install para a sua ferramenta de diretório e, antes de pedir qualquer tarefa, leia os arquivos de origem do skill. Os arquivos-chave deste repositório são SKILL.md, references/blueprints.md, references/cli-commands.md e references/debugging.md. Esses arquivos mostram quais entradas o skill espera e quais flags da CLI realmente importam.

Transforme um objetivo vago em um prompt utilizável

Um prompt fraco diz: “Configure o WordPress Playground para meu plugin.”
Um prompt mais forte diz: “Use wp-playground para criar uma instância local descartável para o plugin em packages/my-plugin, monte o projeto automaticamente, teste contra WP 6.9 e PHP 8.3 e me diga o comando exato da CLI, além de qualquer ajuste de mount ou blueprint.”

Para wp-playground usage, inclua:

• o caminho do projeto,
• se você quer server, run-blueprint ou build-snapshot,
• as versões de WordPress e PHP,
• se o código deve ser montado automaticamente,
• se você precisa de Xdebug ou de um arquivo de blueprint.

Escolha primeiro o fluxo certo

Use server --auto-mount quando quiser uma instância interativa para testes em tempo real. Use run-blueprint quando precisar de uma configuração automatizada que inicia e encerra. Use build-snapshot quando quiser um artefato reutilizável, que possa ser entregue a outra pessoa ou executado novamente depois. Se o objetivo for depuração de backend, descreva o modo de falha exato e peça etapas compatíveis com Xdebug, em vez de pedir apenas um comando de inicialização.

Leia o repositório nesta ordem

Um bom wp-playground guide começa por SKILL.md, depois segue para references/cli-commands.md para entender a forma dos comandos, depois references/blueprints.md se você precisar automatizar a configuração, e por fim references/debugging.md se a tarefa envolver breakpoints, mounts ou execuções travadas. Essa ordem reduz suposições e evita que você deixe passar flags como --mount-before-install ou --blueprint-may-read-adjacent-files.

FAQ do skill wp-playground

O wp-playground é só para demos de frontend?

Não. O wp-playground skill é especialmente útil para desenvolvimento de plugin, tema e backend quando você precisa de comportamento isolado do WordPress, versões reproduzíveis ou sessões de depuração. Ele tem menos a ver com demos visuais e mais com execução controlada.

Preciso primeiro de uma instalação local completa de WordPress?

Normalmente, não. O objetivo de wp-playground install é oferecer um ambiente rápido sem provisionar uma stack tradicional. Se você já tiver uma stack local, wp-playground ainda é útil quando precisar de um alvo limpo para comparação ou de uma combinação específica de WP/PHP.

Quando eu não devo usar?

Não use para dados de produção, trabalho com conteúdo persistente ou fluxos que dependem de comportamento específico do MySQL. Se o seu plugin depende de serviços externos, persistência de arquivos ou estado de longa duração, wp-playground pode não ser a opção certa por padrão, a menos que você consiga modelar explicitamente essas dependências em um blueprint.

Ele é amigável para iniciantes?

Sim, se a tarefa for simples e você seguir de perto os exemplos da CLI. O principal ponto de falha é a entrada vaga: se você não especificar o caminho do projeto, os alvos de versão ou se precisa de um blueprint, o resultado tende a ser menos útil. Iniciantes conseguem melhores resultados quando pedem um fluxo claro por vez.

Como melhorar o skill wp-playground

Dê ao skill as variáveis exatas de configuração

O maior ganho de qualidade vem de informar a raiz do projeto, as versões desejadas de WP/PHP e se o código deve ser montado automaticamente ou explicitamente. Por exemplo: “Use wp-playground para testar plugins/contact-form contra WP 6.9 e PHP 8.3 com --auto-mount” é muito melhor do que “faça funcionar”.

Mencione o modo de falha, não só o objetivo

Se você estiver depurando, diga o que está quebrado: a instalação falha, um hook do plugin não dispara, uma resposta da REST está errada ou um regressão específica de versão só aparece no PHP 8.3. Isso permite que o skill escolha entre server, run-blueprint e build-snapshot, e aumenta a utilidade de qualquer fluxo de wp-playground for Backend Development.

Fique atento a erros de mount e de blueprint

Os problemas mais comuns são caminhos relativos de mount, arquivos que precisam existir antes da instalação e blueprints que precisam ler arquivos locais adjacentes. Se a primeira execução falhar, melhore o prompt adicionando caminhos absolutos, confirmando se --mount-before-install é necessário e informando se o blueprint lê assets locais. Para depuração, peça detalhes da configuração de Xdebug e o mapeamento esperado da IDE.

Itere mudando uma variável por vez

Se a primeira saída estiver perto do ideal, mas ainda errada, altere só uma coisa: versão do WP, versão do PHP, modo de mount ou origem do blueprint. Isso facilita identificar se o problema está na escolha do ambiente, nas flags do comando ou na própria receita de configuração.