umairmsm/wp-site

Site WordPress: da pasta vazia à produção

Este kit é um método mais um projeto inicial. Foi aprendido em um site de reservas multilíngue ao vivo pelo qual clientes reais pagam. Siga as etapas em ordem. Cada etapa termina com um portão: saia de uma etapa apenas quando seu portão for verdadeiro e a evidência estiver registrada.

1. Encontre onde o projeto está

1. Procure por SITE_STATUS.md na raiz do projeto.
   • Ausente: o projeto não foi iniciado. Use wp-kickoff.
   • Presente: leia. O estágio atual é o primeiro estágio com um portão não marcado.
2. Leia AGENTS.md (as regras do projeto), depois as linhas mais recentes de SESSION_LOG.md e DECISIONS.md.
3. Informe ao proprietário em duas linhas: o estágio atual e o próximo passo concreto.

2. Os estágios

#	Estágio	Habilidade	Portão para sair (evidência vai em SITE_STATUS.md)
1	Kickoff	wp-kickoff	Brief aprovado pelo proprietário; decisões bloqueadas registradas; repositório privado; credenciais listadas por nome
2	Design	wp-design	Protótipo estático aprovado (capturas de tela + data); tokens definidos; fontes auto-hospedadas
3	Construção	wp-build	Site local funciona; plugin principal + tema filho ativos; itens reais renderizados através das funções principais; consultas salvas antes de encaminhar; testes de estrutura verdes
4	Conteúdo	wp-content	Cada página pública tem texto aprovado pelo proprietário e fotos reais; páginas legais existem; nenhum texto de IA não aprovado
5	SEO e idiomas	wp-seo	Testes de título, descrição, canônico, schema e hreflang verdes; mapa de redirecionamento de URLs antigas; cada idioma extra passou seu piloto
6	Qualidade	wp-quality	Suíte completa verde; 0 violações de acessibilidade; orçamentos de desempenho atendidos em staging
7	Lançamento	wp-ship	Staging espelha produção; hardening aplicado; launch-auditor PASS; cutover concluído; 7 dias observados
8	Operação	wp-operate	Backups automáticos com cópia fora da máquina; um drill de restauração concluído; rotinas de atualização e alerta escritas

• Entregar o trabalho de um estágio a um agente construtor (Antigravity, Codex, outro Claude): wp-task-file.
• Revisão antes de um merge: agente wp-rules-reviewer. Antes do go-live: agente launch-auditor.

3. Regras rígidas (todo estágio, todo agente)

1. Plugin primeiro. Lógica, dados, texto de política, formulários, schema e SEO vivem no plugin must-use principal. O tema é layout. A skin é a aparência. Um redesign não deve perder uma funcionalidade.
2. Sem cards, preços ou slugs codificados em templates. Consulte o tipo de conteúdo e renderize através da função de renderização do principal, para que uma edição no CMS apareça em todos os lugares.
3. Leads são salvos primeiro. Formulários postam para admin-post.php com um nonce. O site armazena o lead em seu próprio banco de dados, depois o encaminha. Sem chaves de API ou endpoints de terceiros na página.
4. Sem provas falsas. Nunca mostre avaliações, contagens de reviews ou depoimentos que ninguém possa provar. Números de reviews importados ou "legados" contam como falsos até prova em contrário.
5. Fotos reais para qualquer lugar, quarto, produto ou pessoa nomeada. Imagens de IA apenas como cenário geral, nomeadas ai-*, registradas e nunca apresentadas como "este é seu quarto".
6. Fatos vêm do proprietário. Preços, políticas, inclusões e fatos de segurança nunca são inventados. Texto de IA é um rascunho até o proprietário aprová-lo. Desconhecido = PENDING-<quem>.
7. Nenhum PHP escrito por IA para produção sem branch, teste local, diff e um merge humano. Padrões de Codificação WordPress. Prefixe tudo.
8. Sem construtores de página. Sem chamadas ao Google Fonts. Auto-hospede fontes: um tribunal alemão ordenou danos porque carregá-las do Google vazou endereços IP dos visitantes.
9. Staging e local nunca são indexados e nunca enviam e-mails para clientes reais.
10. Testes nunca são enfraquecidos para ficarem verdes: sem deletar, pular ou re-fotografar. Renomear um teste precisa da aprovação do proprietário.
11. Deploys pertencem ao proprietário. A partir de um commit, através de scripts/deploy-safe.sh: dry run primeiro, backup primeiro, a palavra live digitada por um humano.
12. O banco de dados é conteúdo. Altere-o apenas através de um arquivo de alteração revisável e um script protegido com dry run. Faça backup antes de cada alteração no banco de dados.
13. Segredos nunca entram em git, logs, prompts ou na página. CREDENTIALS_INVENTORY.md lista nomes e onde cada segredo vive, nunca valores.
14. Um proprietário de schema (geralmente o plugin de SEO). Nunca produza uma Offer sem um preço.

4. Pergunte ao proprietário primeiro

• Instalar plugins, temas, ferramentas ou serviços pagos (construtores de página: nunca).
• Qualquer alteração em preço, moeda, política, nome de marca ou logotipo. Publicar um novo idioma.
• Qualquer coisa que toque em DNS, Cloudflare, hospedagem, staging ou produção. Comandos destrutivos de banco de dados ou arquivos.
• Enviar código ou conteúdo do cliente para uma API de IA de terceiros.

5. Como trabalhar

• Um estágio de cada vez, um pequeno passo de cada vez. Commit após cada passo significativo (Conventional Commits).
• Branch, teste local, diff, então o proprietário faz o merge. Agentes nunca fazem push, merge, deploy ou ssh para um servidor a menos que o proprietário solicite essa ação exata.
• Cada decisão vai em DECISIONS.md (data, quem, por quê). Termine cada sessão com uma linha em SESSION_LOG.md.
• "Feito" significa verificado: abra a página, execute o teste, leia a resposta do servidor. Nunca repita o "resolvido" de outro agente sem verificar você mesmo.

6. Habilidades úteis de outros kits (se instalados)

• agent-skills-kit: wordpress-modern, wp-plugin-development, wp-wpcli-and-ops, wp-performance para detalhes da API WordPress.
• agent-loop-kit: supervised-build, agent-supervisor para loops de construtor não supervisionados com um portão e um revisor.