As skills do Matt Pocock: programação agêntica mais segura de verdade

Tem uma diferença enorme entre deixar a IA escrever código no vibe e programar de verdade com agente. Eu passei semanas rodando as skills do Matt Pocock no meu fluxo e é isso que elas entregam: disciplina. Não é um prompt esperto, é um ciclo de desenvolvimento inteiro — o agente te entrevista antes de escrever, transforma a conversa em spec, quebra em tickets, implementa com TDD e passa por um code review sério antes de commitar. O repositório já está em 160 mil estrelas e 7 milhões de downloads, e depois de adotar esse fluxo minha programação agêntica ficou visivelmente mais segura. Deixa eu te mostrar o que mudou.

Por que “skill” e não prompt: o que o Matt resolveu

O erro que quase todo mundo comete é tratar o agente como autocomplete gigante: joga um prompt, reza e aceita o que voltar. O Matt inverteu isso. Cada skill é uma peça de um software development lifecycle pensado pra rodar com IA — do planejamento ao commit. Na versão que ele acabou de soltar teve até renomeação que incomoda de propósito: o antigo to-PRD virou to-spec (porque o que a gente criava era uma especificação, não um PRD), e to-issues virou to-tickets (issue puxava demais pro GitHub e Linear; ticket é a jornada que enacta o spec). Fricção boa, porque nomeia a coisa certa. Eu vi ele detalhar tudo isso no vídeo de atualização das skills, e recomendo assistir antes de instalar.

O fluxo completo: grill, spec, tickets, implement, code review

A pergunta que todo mundo faz é “qual é o fluxo principal?”. É este. Primeiro, em vez de usar o plan mode, você deixa um agente te grelhar (grilling) — ele te entrevista e vai montando um glossário e registros de decisão de arquitetura (ADRs) pra capturar o que não é óbvio. Isso vira um spec, que define o destino. O spec é quebrado em tickets, pra você espalhar o desenvolvimento por várias sessões de agente. Cada ticket é implementado com a skill implement, que é propositalmente simples: implemente o que o spec/ticket descreve, use TDD nos pontos de costura combinados, rode type check e testes com frequência, a suíte inteira no fim, chame o code review e faça o commit. Se essa ideia de planejar antes de codar te interessa, eu já defendi ela em Planejamento é engenharia: a meta-skill de planos pra agentes de IA.

Grilling: o agente te entrevista antes de escrever código

Essa é a peça que mais me deu segurança. Em vez de o agente sair codando em cima de suposição, o grilling força ele a extrair o que está na sua cabeça primeiro. O Matt afinou três coisas nessa versão que atacam exatamente os furos de segurança do fluxo: o agente agora pergunta uma coisa de cada vez (várias perguntas juntas confundem e levam a resposta preguiçosa), ganhou um gate de confirmação — não executa o plano até você confirmar que existe entendimento compartilhado — e passou a separar fatos (o que o agente descobre sozinho explorando o código) de decisões (que só você pode tomar). Antes, em alguns modelos, ele pulava a entrevista e ia direto pra implementação, ou pior, se entrevistava sozinho. Esse gate é o que impede o agente de decidir por você.

Code review em dois eixos e os smells do Martin Fowler

O code review é onde a qualidade trava de verdade, e ele roda em dois eixos, cada um num sub-agente paralelo. O primeiro é o eixo de padrões: o código respeita o coding-standards.md documentado do repositório? (Ele defende, com razão, que padrões de código vivem fora do agents.md — é no review que eles rendem mais.) O segundo é o eixo do spec: o código implementa fielmente o issue, PR ou spec de origem? A parte nova e sacana é que o Matt releu o Refactoring do Martin Fowler e plugou os smells clássicos no review — mysterious name, duplicated code, feature envy, data clumps, primitive obsession, message chains, middle man. Como esse livro é citadíssimo, esses nomes já estão fundo no conhecimento do modelo: basta descrever cada um numa frase que o agente devolve “achei message chains aqui, preciso remover”. Ele testou por duas semanas e chamou de absurdamente útil — dez linhas de skill que elevam a qualidade do código.

Wayfinder: planejar o que é grande demais pra uma sessão

Esse é o que mais me empolgou. O Wayfinder é um passo pré-spec pra quando a ideia é grande demais pra caber numa sessão de agente — quando você estoura a “zona esperta” do modelo ou a própria janela de contexto. A metáfora dele é boa: uma ideia solta chegou, grande demais pra uma sessão e envolta em névoa; o caminho até o destino ainda não é visível. O Wayfinder desenha esse caminho como um mapa no issue tracker do repositório. Cada decisão vira um sub-issue no GitHub, com relações de bloqueio (essa decisão não pode ser tomada antes daquela), e cada uma é dimensionada pra caber numa sessão. Os tickets têm tipos: research (tarefa AFK pro agente pesquisar e voltar), grilling (precisa de entrevista), prototype (fazer um artefato concreto e barato pra reagir a ele) e task (a config chata que não precisa de decisão). Fechados todos os tickets, tudo é salvo no mapa e vira um spec do jeito normal. Em vez da ansiedade de gerenciar handoff de sessão, está tudo no GitHub e é colaborativo com o time.

TDD, prototype e research: as peças que fecham o ciclo

Três skills menores completam o quadro. A de TDD agora é só material de referência: não prescreve passos (o que travava agentes AFK), só a ordem — red antes de green, uma fatia por vez — e tirou o refactor do loop, jogando ele pro code review pra não sobrecarregar a implementação. A de prototype te dá escolha entre protótipo de lógica ou de UI, pra levantar a fidelidade da discussão com um artefato concreto barato — essencial pra qualquer coisa que toca front-end. E a de research sobe um agente em background pra investigar contra fontes primárias e salvar as descobertas num markdown seguindo a convenção do repo, enquanto você segue trabalhando. Se você curte a ideia de skill que vira artefato executável, eu explorei algo parecido em planf3 na prática: a skill que transforma planos de IA em HTML executável e no Loop Engineering.

Conclusão: programar de verdade com agente

O que essas skills me deram não foi velocidade — foi confiança. (1) O grilling e o gate de confirmação impedem o agente de decidir sozinho o que era seu pra decidir; (2) o code review em dois eixos com os smells do Fowler pega o código ruim antes de ele virar dívida; (3) o Wayfinder tira a ansiedade de planejar coisa grande fatiando em decisões do tamanho de uma sessão. É a diferença entre torcer pra dar certo e ter guard rails em cada etapa. Se você quer programar de verdade com IA, instale as skills com npx skills add mattpocock/skills e comece pelo fluxo grill → spec → tickets. Está tudo aberto no repositório de skills do Matt Pocock, e o passo a passo completo está no vídeo de atualização.