Parte 1: Por que a engenharia de agentes não é codificação de vibe Uma amiga recentemente postou sobre habilidades de IA usando a analogia da Matrix: Trinity não aprende a voar um helicóptero - Tank carrega um programa preciso e verificado diretamente em sua mente. Essa analogia é perfeita, mas expõe um equívoco fundamental sobre como esses sistemas são realmente construídos. Trindade não vibra seu caminho para voar. tanque carrega um . Programas precisos e verificados Essa é a diferença entre codificação de vibe e o que Addy Osmani chama "Codificação Vibe" envenenou o poço - sugere que você pode encaminhar seu caminho para o software de produção. Engenharia Agência Tenho mais de 70 agentes no meu fluxo de trabalho de desenvolvimento web3. Eles não são desperdícios rápidos. Eles são estruturados: responsabilidades claras, arquivos de conhecimento explícitos, pontos de mão definidos entre agentes. Construí-los levou o mesmo pensamento arquitetônico que sempre separou os sistemas de trabalho do caos. Os princípios antigos traduzem diretamente: DRY → DRYP (Não repita sua prompt) Separação de preocupações → Fronteiras de agentes Design de interface → Contratos Handoff Documentação Precompilado Contexto Construir boas habilidades é trabalho de arquitetura.A cena da Trindade funciona porque alguém Esse programa piloto.O tanque não o codificou. Engenheiro O problema que começou tudo A maior coisa que aprendi na construção de fluxos de trabalho de codificação de IA: . more context is not better Eu trabalho na web3. tenho ABIs que são milhares de linhas. Um esquema de banco de dados Ponder que comeria metade da janela de contexto se eu o alimentasse em bruto. Isso não funciona. A IA se perde. Instruções importantes são ignoradas. Ele se apega a detalhes aleatórios. Os resultados pioram à medida que o contexto se torna maior. Há um termo para isso: À medida que a janela de contexto se preenche, as instruções anteriores ficam "cobertas" e o modelo começa a ignorá-las. context rot Então eu construí um agente especialista em habilidades. Seu único trabalho é pré-compilar o contexto para outros agentes. Ele lê meus ABIs brutos, esquemas e documentos, em seguida, gera arquivos de referência finos adaptados a tarefas específicas. Quando eu preciso do trabalho do UI feito, eu não entrego ao meu designer ui toda a base de códigos. O especialista em habilidades já construiu uma referência de componentes com apenas os props e padrões que o agente precisa. Quando eu preciso de integração de contrato, o implementador web3 recebe apenas as funções e eventos relevantes. Agents building context for agents. O modelo mental da hierarquia da memória O modelo mental que fez tudo clicar: trate o contexto como RAM, não uma gaveta de lixo. Layer What It Holds Disk Full codebase, raw ABIs, complete schemas RAM Precompiled skills — task-specific reference files Registers The current prompt and immediate context Discos Base de códigos completa, ABIs crus, esquemas completos RAM Habilidades pré-compiladas – ficheiros de referência específicos de tarefas Registros O contexto atual e imediato Você não carrega tudo na memória. Você carrega o que você precisa para a tarefa atual. Meu especialista em habilidades é o compilador que transforma o disco em RAM. Sem ele, estou de volta ao contexto de enchimento e esperando o melhor. O que uma habilidade pré-compilada parece Aqui está o padrão que meu especialista em habilidades gera: # MorphoVault Reference > Use when implementing vault deposit/withdraw flows. ## Terminology - **shares**: Vault shares representing proportional ownership - **assets**: The underlying token being deposited ## Key Functions ### deposit(uint256 assets, address receiver) → uint256 shares Deposits assets and mints shares to receiver. See: protocols/morpho/abis/MetaMorpho.json ### withdraw(uint256 assets, address receiver, address owner) → uint256 shares Burns shares and sends assets to receiver. See: protocols/morpho/abis/MetaMorpho.json ## Events ### Deposit(address indexed sender, uint256 assets, uint256 shares) ### Withdraw(address indexed sender, uint256 assets, uint256 shares) ## Related Hooks - useVaultDeposit: src/hooks/blockchain/useVaultDeposit.ts - useVaultBalance: src/hooks/ponder/useVaultBalance.ts Curto. Scannable. Pointers para arquivos de origem. Termos de domínio definidos. Seções claras. Esta referência é de 30 linhas e contém tudo o que um agente precisa para implementar um fluxo de depósito. A arte por trás da cortina Meu criador de habilidades é em si uma habilidade – uma que construí através de iterações, testes e pensamento arquitetônico. Cada habilidade no meu sistema tem: Responsabilidades claras – O que esse agente possui? Arquivos de conhecimento explícito – Que contexto pré-compilado é necessário? Pontos Handoff Definidos – Quando chama outros agentes? Critérios de verificação - Como sabemos que foi feito? Isso não é vibração, isso é engenharia. A visão de distribuição é correta – as habilidades comprimem a distância entre o usuário e o valor.Mas alguém ainda tem que construí-las bem. Chegando em Parte 2 Em seguida, vou cobrir a descoberta organizacional que tornou mais de 70 agentes gerenciáveis: a distinção entre (Pessoas com quem você está conversando) e (Os trabalhadores que você enviou) skills agents Acontece que apenas ~10 era necessário para ser conversacional.O resto só era necessário para ser descoberto. Esta é a parte 1 de "Lessons from Building a 100+ Agent Swarm in Web3." Segue a parte 2 sobre organização de agentes, ou conecte-se se você estiver construindo sistemas semelhantes.
