Posts

Showing posts with the label Software Engineering

Como construir agentes com limites claros

Um módulo, uma pergunta, seis artefatos locais e um coordenador que sabe onde o sistema pode falhar O que este artigo cobre Por que a estrutura de pastas não cria uma fronteira real sem decisões, entradas, saídas, proibições e evidências explícitas. Como módulos com uma pergunta só contêm erros e tornam as recusas diagnosticáveis. Quais seis artefatos locais transformam um módulo numa unidade de trabalho verificável. O que um coordenador deve validar, o que ele não deve reinterpretar e onde a liberação humana continua necessária. Quando dividir o trabalho melhora o isolamento de falhas e quando o custo de coordenação piora o sistema. Na primeira parte eu expliquei por que um contexto enorme e um modelo caro não salvaram um projeto anonimizado de otimização de rotas. O agente escrevia código. O sistema não conseguia explicar qual decisão tinha eliminado uma rota viável. Agora vem a parte de engenharia. A versão curta é simples: não divida uma aplicação de agentes por substant...

How to Build Bounded Agents

One module, one question, six local artifacts, and a coordinator that knows where the system can fail What this article covers Why directory structure is not a real boundary until decisions, inputs, outputs, prohibitions, and evidence are explicit. How one-question modules contain errors and make refusals diagnosable. Which six local artifacts turn a module into a verifiable unit of work. What a coordinator should validate, what it should not reinterpret, and where human release remains necessary. When splitting work improves fault isolation, and when coordination cost makes the system worse. The first part explained why a large context and an expensive model did not rescue an anonymized route optimization project. The agent could write code. The system could not explain which decision had removed a viable route. This part is the engineering answer. The short version is simple: do not divide an agentic application by nouns. Divide it by decisions. "Everything about ord...