Insights e Artigos
Reflexões sobre transformação com IA, a era da especificação, workflows agênticos e lições de duas décadas no campo.
Implicacoes para Lideres, Engenheiros e a Empresa
O padrao que descrevi neste livro (especificacoes estruturadas, controle de workflow deterministico, execucao de agentes delimitada, portoes de avaliacao automatizados) nao e teorico. Equipes estao rodando em producao hoje.
Implications for Leaders, Engineers, and the Enterprise
The pattern I've described in this book (structured specifications, deterministic workflow control, bounded agent execution, automated evaluation gates) is not theoretical. Teams are running it in production today, from two-person startups to enterprise organizations in heavily regulated industries.
Da Branch Vazia ao Pull Request: A Fabrica Completa em Acao
Vou percorrer o workflow completo usando um exemplo pratico. Imagine que estamos construindo um sistema de gerenciamento de alertas para uma operacao de mineracao (algo que efetivamente ja escopi para clientes).
From Blank Branch to Pull Request: The Full Factory in Motion
Let me walk through the complete workflow using a practical example. Imagine we're building an alert management system for a mining operation (something I've actually scoped for clients).
O Paradoxo do Waterfall: Por Que Sequencial E Rapido de Novo
O SDLC agentico reintroduz fases sequenciais (requisitos antes de design, design antes de codigo) e isso melhora os resultados. Se voce viveu a era waterfall original ou leu sobre seus fracassos, isso soa contraditorios. Nao e.
The Waterfall Paradox: Why Sequential Is Fast Again
I'll say something that will make a few people uncomfortable: the teams achieving the strongest results with AI agent systems are running development workflows that look remarkably similar to the phased, sequential approach the industry spent twenty years rejecting.
Institutional Memory Without the Institution
Every experienced engineer carries a mental model of their system that took months or years to build. This institutional knowledge is enormously valuable, and in traditional organizations, it walks out the door whenever someone changes roles or leaves the company.
Memoria Institucional Sem a Instituicao
Todo engenheiro experiente carrega um modelo mental do sistema que levou meses ou anos para construir. Esse conhecimento institucional e enormemente valioso e, em organizacoes tradicionais, vai embora quando alguem muda de cargo ou sai da empresa.
O Portao de Avaliacao: Sem Aprovacao, Sem Progresso
Se voce levar uma coisa deste livro, que seja esta: avaliacoes sao a diferenca entre um sistema agentico que produz software confiavel e um que produz lixo bonito em alta velocidade.
The Eval Gate: No Pass, No Progress
If you take one thing from this book, let it be this: evaluations are the difference between an agentic system that produces reliable software and one that produces confident-looking garbage at high speed.
Building the Agent Team: Why Specialization Wins
The typical agent roster in a mature implementation includes four to five purpose-built agents, each defined by a narrow scope, explicit input/output contracts, and a clear rubric for what constitutes acceptable output.
Montando o Time de Agentes: Por Que Especializacao Vence
O elenco tipico numa implementacao madura inclui quatro a cinco agentes especializados, cada um definido por escopo restrito, contratos explicitos de input/output e uma rubrica clara do que constitui output aceitavel.
Seu Repositorio como Motor de Workflow: Convencao Sobre Configuracao
Um dos padroes mais elegantes do desenvolvimento spec-driven e como ele usa a estrutura de arquivos e pastas do repositorio como contrato de workflow legivel por maquina. O mesmo principio, aplicado ao desenvolvimento orientado por agentes, transforma seu repositorio num motor de workflow auto-descritivo.
Your Repo as a Workflow Engine: Convention Over Configuration
One of the more elegant patterns in spec-driven development is how it uses the repository's file and folder structure as a machine-readable workflow contract. The same principle, applied to agent-driven development, turns your repository into a self-describing workflow engine.
Duas Camadas, Um Sistema: Separando o Cerebro dos Musculos
O padrao arquitetural que entrega resultados mais consistentes separa o sistema em duas responsabilidades: uma camada de controle deterministica que gerencia a progressao do workflow, e uma camada de execucao criativa onde agentes fazem o trabalho real.
Two Layers, One System: Separating the Brain from the Muscles
The architectural pattern delivering the most consistent results in production separates the system into two distinct responsibilities: a deterministic control layer that manages workflow progression, and a creative execution layer where AI agents do their actual work.
Desenvolvimento Spec-Driven: Quando a Industria Inteira Chega na Mesma Conclusao
Ao longo de 2025, multiplas organizacoes, trabalhando independentemente, convergiram no mesmo insight: a qualidade do que agentes de IA produzem e quase inteiramente determinada pela qualidade e estrutura das instrucoes que recebem.
Spec-Driven Development: When an Entire Industry Reaches the Same Conclusion
Throughout 2025, multiple organizations, working independently and with different motivations, converged on the same fundamental insight: the quality of what AI agents produce is almost entirely determined by the quality and structure of the instructions they receive.
O Teto do Copilot: Por Que Digitar Mais Rapido Nunca Resolveu o Problema Real
A lideranca tecnica apresenta numeros impressionantes de produtividade dos desenvolvedores assistidos por IA. Tempos de conclusao cairam 30 a 40 por cento. Mas quanto mais rapido uma capacidade de negocio sai do quadro branco para a producao? Essa pergunta tende a cair de forma diferente na sala.
The Copilot Ceiling: Why Faster Typing Never Fixed the Real Problem
The technology leadership team presents impressive productivity numbers for their AI-assisted developers. Completion times down 30 to 40 percent. But how much faster does a business capability get from whiteboard concept to live production? That question tends to land differently.