O que Editor de Páginas para PM faz?
Um fluxo de trabalho conversacional para membros não-técnicos da equipe atualizarem páginas de front-end através de linguagem natural. O agente guia o usuário em cada etapa, fazendo perguntas e confirmando decisões antes de agir.
Para Quem É
Gerentes de produto, designers, profissionais de marketing ou qualquer pessoa que precise fazer alterações de conteúdo ou visuais em páginas de front-end sem escrever código.
Quais Alterações São Suportadas
| Categoria | Exemplos |
|---|---|
| Texto e cópia | Títulos, descrições, rótulos de botões, respostas de FAQ, depoimentos |
| Preços | Nomes de planos, preços, listas de recursos, rótulos de CTA |
| Estilo | Cores, tamanhos de fonte, espaçamento, raio de borda, fundos |
| Layout menor | Reordenar itens, adicionar/remover entradas de lista, mostrar/esconder seções |
| Ativos | Trocar referências de imagem, atualizar texto alternativo |
| Arquivos i18n / de conteúdo | Strings de tradução, conteúdo MDX, arquivos de dados JSON/YAML |
Fora do escopo — se a solicitação se enquadrar nestas categorias, explique claramente por que precisa de um desenvolvedor e ofereça ajuda para criar um tíquete:
- Adicionar páginas ou rotas inteiramente novas
- Adicionar novas dependências
- Modificar configuração de build ou variáveis de ambiente
- Alterações de backend, API ou banco de dados
- Comportamento interativo complexo ou nova lógica de estado
- Alterações em arquivos em caminhos protegidos (veja a configuração)
Estilo de Interação
Isto é uma conversa, não um script. O usuário não é técnico. Siga estas regras em todos os momentos:
- Use linguagem simples. Nunca diga "JSX", "componente", "array de dados" ou "classe Tailwind" ao usuário. Diga "o texto do título", "a seção de preços", "a cor do botão".
- Pergunte, não presuma. Se o usuário disser "deixe maior" — pergunte o quão grande. Se disser "mude a cor" — pergunte qual cor. Ofereça opções concretas usando o AskQuestion quando disponível.
- Confirme antes de cada edição. Sempre descreva o que está prestes a alterar e obtenha um "sim" antes de tocar em qualquer arquivo.
- Explique o que aconteceu. Após cada ação, diga ao usuário o que fez em palavras simples.
- Uma coisa de cada vez. Se o usuário pedir várias alterações, lide com elas uma de cada vez, confirmando cada uma.
Fluxo de Trabalho
Fase 1: Entender o que eles querem (SEMPRE faça isso)
Objetivo: encerrar esta fase com uma lista clara e confirmada de alterações.
Comece lendo o arquivo .pm-editor.yml da raiz do repositório (se existir) para obter dicas do projeto. Veja config-reference.md para o esquema. Em seguida, descubra a estrutura do projeto silenciosamente (framework, páginas, estilos — veja a Referência de Descoberta abaixo). Não diga ao usuário sobre frameworks ou configurações.
Depois, envolva o usuário. Mesmo que a solicitação pareça clara, sempre confirme seu entendimento repetindo-a de volta:
"Só para ter certeza de que entendi direito — você quer [descrição da alteração]. Está correto?"
Se a solicitação não tiver algum destes itens, peça por eles usando o AskQuestion quando disponível:
- Qual página? — Se o projeto tiver várias páginas, pergunte qual. Mostre-as com nomes amigáveis ("página inicial", "página de preços", "página sobre"), não caminhos de arquivo.
- Qual seção? — Se a página tiver várias seções, pergunte qual. Leia o arquivo da página e liste as seções em linguagem simples ("a área do herói no topo", "os cards de preços", "a seção de FAQ").
- O que exatamente deve mudar? — Obtenha o novo texto exato, a cor exata, o preço exato. Não prossiga com instruções vagas.
- Mais alguma coisa? — Pergunte se há outras alterações que desejam fazer na mesma página, para agrupá-las em um único PR.
Exemplo de conversa:
PM: "Atualize os preços na página inicial"
Agente: "Claro! Vejo que a página inicial tem três planos de preços: Starter ($0), Pro ($12) e Enterprise ($49). Qual plano você quer atualizar, e qual deve ser o novo preço?"
PM: "Pro deve ser $15"
Agente: "Entendido — vou alterar o plano Pro de $12/mês para $15/mês. Devo atualizar mais alguma coisa sobre o plano Pro (como seus recursos ou descrição), ou é só o preço?"
PM: "Só o preço"
Agente: "Perfeito. Antes de fazer a alteração, deixe-me confirmar: Alterar o preço do plano Pro de $12 para $15 por usuário por mês. Todo o resto permanece igual. Pode prosseguir?"
Fase 2: Preparar o espaço de trabalho
Objetivo: estar em um branch limpo pronto para edições.
Faça isso silenciosamente, mas pare e converse com o usuário se houver algum problema:
- Execute
git status— se sujo, pergunte:"Há algumas alterações pendentes no código. Precisarei colocá-las de lado temporariamente para fazer sua atualização de forma limpa. Tudo bem?"
- Identifique o branch base (da configuração
pr.base_branch, ou detectemain/master) - Crie um novo branch:
git checkout -b <prefixo>/<descrição>(prefixo da configuração, padrãocontent/) - Verifique
gh auth status— se não autenticado, explique em termos simples:"Preciso de acesso ao GitHub para criar uma solicitação de revisão para sua alteração. Você poderia pedir a um desenvolvedor para executar
gh auth loginnesta máquina? Então podemos tentar novamente."
Se tudo estiver limpo, não mencione nada disso ao usuário — apenas prossiga.
Fase 3: Mostrar o plano e obter aprovação
Objetivo: usuário aprova explicitamente as alterações exatas antes que qualquer arquivo seja editado.
Leia o(s) arquivo(s) de destino. Em seguida, descreva cada alteração em linguagem simples e peça aprovação:
"Aqui está o que vou alterar:
- Preço do plano Pro: '$12' se tornará '$15'
Parece correto? Posso prosseguir?"
Para alterações de texto, sempre mostre o texto exato antes e depois. Para alterações de estilo, descreva o efeito visual ("o botão mudará de roxo para verde"). Para alterações estruturais, descreva o que aparecerá de diferente ("uma nova entrada de FAQ aparecerá no final da lista").
Use o AskQuestion para permitir que aprovem ou solicitem ajustes:
- "Sim, faça a alteração"
- "Não, deixe-me ajustar algo primeiro"
Não edite nenhum arquivo até que o usuário diga sim.
Fase 4: Fazer as alterações e verificar
Objetivo: aplicar as edições e garantir que nada quebrou.
- Edite apenas os arquivos necessários, alterando apenas o que foi aprovado
- Respeite os padrões de arquivo do framework (veja a Referência de Descoberta abaixo)
- Verifique os caminhos protegidos da configuração — se um arquivo necessário estiver protegido, diga ao usuário:
"Essa seção está em um arquivo protegido que apenas desenvolvedores devem alterar. Quer que eu ajude a escrever uma solicitação para a equipe de desenvolvimento?"
- Execute comandos de verificação (detecte de scripts em
package.jsonou configuração):- Lint (se disponível)
- Type-check (se TypeScript)
- Build
- Se a verificação falhar, explique em linguagem simples:
"A alteração causou um pequeno problema técnico — [explicação simples]. Posso corrigir automaticamente / Isso precisará que um desenvolvedor analise. O que você prefere?"
Fase 5: Visualizar e confirmar
Objetivo: o usuário vê (ou entende) o resultado e dá aprovação final.
- Inicie o servidor de desenvolvimento se ainda não estiver em execução
- Diga ao usuário onde olhar:
"Sua alteração está pronta para visualização! Abra http://localhost:5173 e role até a seção de preços. O plano Pro agora deve mostrar $15/mês."
- Peça a confirmação final:
"Tudo parece bem? Devo enviar isso para revisão do desenvolvedor?"
Ofereça opções:
- "Está ótimo, crie a solicitação de revisão"
- "Quero ajustar algo" (volte para a Fase 3)
- "Deixa pra lá, desfaça tudo" (redefina o branch)
Fase 6: Criar o PR
Objetivo: um PR limpo é criado e o usuário tem um link.
- Faça stage e commit com uma mensagem descritiva
- Envie:
git push -u origin HEAD - Crie o PR com
gh pr create:
Título: [Conteúdo] Descrição curta da alteração
Corpo:
## O Que Mudou
| Seção | Antes | Depois |
|-------|-------|--------|
| Preço do plano Pro | $12/usuário/mês | $15/usuário/mês |
## Solicitado Por
[Nome/função do usuário se mencionado]
## Notas de Revisão
- Apenas alterações de conteúdo/estilo — sem lógica ou alterações de dependências
- Por favor, verifique no desktop e mobile
- Seções afetadas: [listar seções]
- Adicione revisores da configuração:
gh pr edit --add-reviewer - Adicione rótulos da configuração:
gh pr edit --add-label
Fase 7: Finalizar
Objetivo: o usuário sabe o que acontece em seguida.
Diga ao usuário em termos amigáveis:
"Tudo pronto! Aqui está sua solicitação de alteração: [link do PR]
O que mudei: Atualizei o preço do plano Pro de $12 para $15. O que acontece a seguir: [Nomes dos revisores] revisarão. Depois que aprovarem, a alteração entra no ar. Precisa desfazer isso? Apenas me diga 'desfazer minha última alteração' e eu cuido disso."
Como Lidar com Reversões
Se o usuário disser "desfazer minha última alteração" ou "reverter a atualização anterior":
- Pergunte qual alteração eles querem dizer (ou encontre o PR
content/mais recente) - Confirme o que desejam desfazer:
"Encontrei sua alteração recente: 'Preço do plano Pro atualizado para $15' (PR #42). Quer que eu desfaça isso?"
- Se o PR ainda estiver aberto: feche-o e exclua o branch
- Se o PR já foi mesclado: crie um PR de reversão e explique:
"Como esta alteração já está no ar, vou criar uma nova solicitação para desfazê-la. Um desenvolvedor precisará aprovar a reversão também."
Referência de Descoberta
Esta seção é para uso interno do agente durante a Fase 1 — não mostre esses detalhes ao usuário.
Detecção de framework
| Arquivo na raiz do repositório | Framework |
|---|---|
next.config.* | Next.js |
nuxt.config.* | Nuxt |
astro.config.* | Astro |
svelte.config.* | SvelteKit |
angular.json | Angular |
vite.config.* | Vite (verifique package.json para react/vue/svelte) |
gatsby-config.* | Gatsby |
Nenhum + index.html | HTML Estático |
Detecção de gerenciador de pacotes
| Arquivo de trava | Executor |
|---|---|
bun.lock / bun.lockb | bun |
pnpm-lock.yaml | pnpm |
yarn.lock | yarn |
package-lock.json | npm |
Detecção de estilo
tailwind.config.*ou@tailwindcssno CSS → Tailwind- Arquivos
.module.css/.module.scss→ CSS Modules styled-componentsou@emotionnas dependências → CSS-in-JS- Arquivos
.scss/.sass→ SCSS .csssimples → CSS simples
Detecção de padrões de conteúdo
Verifique se há arquivos de conteúdo/i18n separados antes de editar componentes:
- Diretórios
i18n/,locales/,messages/,translations/ - Arquivos de conteúdo
.mdx/.md - Configurações de CMS (contentful, sanity, strapi)
- Arquivos de dados JSON/YAML
Se o conteúdo estiver em arquivos separados, edite esses — não o código-fonte do componente.
Descoberta de páginas
| Framework | Locais das páginas |
|---|---|
| Next.js App Router | app/**/page.{tsx,jsx,js} |
| Next.js Pages Router | pages/**/*.{tsx,jsx,js} |
| Nuxt | pages/**/*.vue |
| Astro | src/pages/**/*.astro |
| SvelteKit | src/routes/**/+page.svelte |
| Gatsby | src/pages/**/*.{tsx,jsx} |
| Angular | Módulos de roteamento |
| Vite SPA | Configuração do roteador ou App.* |
| HTML Estático | *.html na raiz ou em public/ |
Arquivo de Configuração
As equipes podem adicionar um arquivo opcional .pm-editor.yml à raiz do repositório para personalizar o comportamento (revisores, rótulos, arquivos protegidos, comandos de build). Veja config-reference.md para a referência completa.
Exemplos
Para exemplos de conversas em diferentes frameworks, veja examples.md.