Pedro Serey (VTEX)

Wed, 21 Oct 2026 00:00:00 -0300

Conversa com o Pedro Serey, engenheiro de software de Developer Experience na VTEX, sobre o workflow pessoal que ele usa com agentes de código, usando o OpenCode como ferramenta. A apresentação do Pedro está disponível no youtube. Aqui eu vou escrever um pouco sobre o que discutimos.

Minha principal observação: mais uma vez ficou claro que, por trás de workflows diferentes, estão os mesmos princípios fundamentais. O workflow de Pedro não é igual ao do Matt Pocock, que não é igual ao do Jonhnny Weslley e assim por diante. Cada um organiza etapas, ferramentas e nomes do seu jeito. Mas todos giram em torno do mesmo núcleo: entender, alinhar, especificar, implementar e validar. A forma muda, o princípio não muda.

A outra observação é sobre onde está o trabalho de quem desenvolve hoje. O modelo por trás do agente já sabe muito, mas é genérico. O que diferencia um bom uso de um uso mediano é a personalização: usar skills, MCPs e engenharia de contexto para que o agente produza o que aquele time e aquele projeto esperam. As preferências da equipe, os artefatos esperados, o jeito de programar daquele projeto, nada disso vem pronto no modelo, é contexto que a gente constrói.

Alguns pontos

O uso combinado do /grill-me com o /plannotator é excelente para a fase de entendimento.
Muitas das tasks de Pedro envolvem vários repositórios ao mesmo tempo. A solução dele foi criar um diretório workspace reunindo todos os repositórios separadamente, com um AGENTS.md explicando a organização, e um diretório tasks-artifacts onde, para cada task, ele mantém o PLAN.md, o TODO.md e um diretório evidencias.

Referências de Pedro

Repositório com as skills e o AGENTS.md usados na demo
Plannotator
Herdr — multiplexador de terminal para agentes
Tweet de Robert C. Martin

Jonhnny Weslley (NexHealth)

Fri, 16 Oct 2026 00:00:00 -0300

Conversa com o Jonhnny Weslley, dev senior na NexHealth, sobre como o time dele usa agentes de código no dia a dia. A apresentação de Jonhnny está disponível no youtube. Aqui eu vou escrever um pouco sobre o que discutimos e colocar alguns shorts que selecionei para a discussão.

Minha principal observação: Jonhnny apresentou o workflow usado por ele. Foi interessante ver que é muito alinhado com o que estamos vendo em sala de aula e com o que outros devs relatam. Sobretudo o RPI, RePPIT e o workflow do Matt Pocock. No final das contas, sempre é sobre entender, projetar, implementar e validar :)

O que aprendemos

Uma sessão de “grilling” com o agente te entrevistando antes de implementar não é só para extrair requisitos. É o que fixa a decisão na sua cabeça e na do agente. Uma espécie de onboarding para a tarefa.
Delegar decisão para o agente sem esse processo ganha produtividade, mas tem um custo: conhecimento que deveria ficar com você fica só no código, porque foi o agente que decidiu sem te envolver.
O que separa um time que usa bem agentes de um que não usa não é o modelo ou o AI code agent escolhido, é o workflow: quebrar tarefas, especificar antes de implementar, ter roteiro de teste e sensores bem definidos. A parte determinística — revisão e controle de qualidade — continua na mão de quem desenvolve.
Segurança de agente também é parte do workflow: a NexHealth construiu uma ferramenta que valida toda consulta SQL antes do agente executá-la no banco, bloqueando qualquer coisa que vaze dado sensível ou peça acesso a credenciais (AWS, por exemplo) sem motivo. Tudo implementado via hooks.
Nunca instale uma skill da web sem ler o que ela executa, mesmo vindo de fonte confiável. O pacote pode ter sido comprometido no caminho. Ataques recentes ao GitHub miravam exatamente isso.

Trechos da conversa

Grilling: o agente te interrogando antes de implementar

Aqui eu defendo sessões de “grilling”. O ganho não é só alinhar o agente com o que você quer: o processo força você a pensar mais profundamente no problema, e esse conhecimento fica com você, não só com quem (ou o que) implementou. Delegar essa etapa sem passar por ela dá produtividade, mas tira de você decisões que talvez devessem ficar na sua cabeça.

Workflow importa mais que o modelo

Não adianta ter o melhor modelo ou o melhor AI code agent se você não quebra as tarefas, não define especificação antes de implementar e não tem roteiro de teste com sensores bem definidos. Monitorar e avaliar é fundamental nessa nova forma de desenvolver.

Validação automática de SQL antes de qualquer consulta

O time da NexHealth criou uma ferramenta que intercepta toda consulta SQL que o agente tentar executar no banco. Antes de rodar, ela valida se aquela consulta vazaria alguma informação que não deveria — se vazar, o comando é bloqueado. O mesmo mecanismo serve para bloquear pedidos sem sentido, como o agente tentar ler credenciais da AWS no meio de uma tarefa que não precisa disso. Implementado com hooks.

O perigo de instalar skills sem ler o que elas fazem

Alerta direto: não confie cegamente em skills disponíveis na web, mesmo as que prometem reduzir seu trabalho em 90%. Algumas, no fim do código, fazem scan de chaves de AWS ou GitHub e enviam para um endereço externo. E mesmo uma skill de fonte confiável pode ter sido comprometida durante o download. Jonhnny cita os ataques recentes ao GitHub, em que invasores conseguiram permissão para dar push em repositórios justamente para injetar comandos maliciosos que executam quando alguém baixa a skill.

Conversas com a indústria on Desenvolvimento de Software com Agentes e IA Generativa