hmdeveloper.com
Todos os artigos
agentesskillssegundo-cerebro

Modelo, contexto, skill, ferramenta, agente, squad

Seis palavras parecem sinônimos quando você sai do chat comum. Separar cada uma evita pedir ao modelo uma coisa que deveria morar em outro lugar.

O primeiro tropeço de quem sai do chat comum é chamar tudo de agente. Troca o modelo e espera que ele conheça a empresa. Escreve uma instrução longa e espera que ela vire ferramenta. Conecta uma ferramenta e espera que ela resolva falta de contexto. A frustração vem daí.

O que eu faço hoje é separar seis coisas antes de desenhar qualquer automação: modelo, contexto, skill, ferramenta, agente e squad. Cada uma responde a uma pergunta diferente.

Modelo

Modelo é o que raciocina. É a parte que lê a pergunta, combina padrões, escreve texto, decide o próximo passo. Quando eu troco o modelo, estou trocando a qualidade e o tipo de raciocínio: mais ou menos cuidado, mais ou menos capacidade de seguir uma cadeia longa, mais ou menos disciplina para usar ferramentas.

Quando preciso disso? Quando a tarefa exige raciocínio melhor ou um modo diferente de trabalhar. Arquitetura difícil, revisão cuidadosa, escrita com restrições. Trocar modelo não ensina nada sobre mim. Um modelo melhor continua sem saber meus projetos se eu não der contexto.

Contexto

Contexto é o que o sistema sabe sem eu reexplicar. Não é a conversa inteira. Conversa evapora e carrega ruído. Contexto bom é arquivo: decisão escrita, perfil de cliente, regra de produto, glossário, histórico que alguém consegue abrir de novo.

Quando preciso disso? Quando a resposta depende de mim, da empresa ou de um projeto. Se peço uma proposta, um plano de venda ou uma revisão sem contexto, o modelo devolve uma média da internet. O melhor modelo ainda escreve genérico quando a base é genérica.

Skill

Skill é um procedimento que o agente aprendeu a reconhecer e seguir. Não é memória. É modo de trabalho. Se toda vez que reviso um plano eu olho riscos, bloqueadores e testes mínimos, isso vira skill. O valor está em parar de reexplicar o ritual.

Quando preciso disso? Quando a tarefa se repete com passos parecidos. Uma skill boa não tenta guardar tudo; ela diz como agir, o que verificar e quando parar. Se o problema é falta de informação, skill não resolve. Ela só executa melhor um procedimento.

Ferramenta

Ferramenta, ou MCP, é a capacidade de agir fora do próprio modelo. Ler um banco, buscar na web, abrir um documento, mexer em outro aplicativo. Sem ferramenta, o modelo só fala. Ele pode escrever um plano perfeito e ainda assim não alterar nada no mundo.

Quando preciso disso? Quando a tarefa exige estado externo ou ação externa. Ver o calendário, consultar uma base, criar um card, ler um arquivo que não está no contexto. A ferramenta não pensa por você; ela dá mãos ao raciocínio.

Agente

Agente é papel com contexto, ferramentas e objetivo. Ele tem nome porque você quer chamar aquele papel de novo: revisor de PR, pesquisador, analista, editor. O nome evita remontar a mesma combinação toda vez.

Quando preciso disso? Quando um trabalho recorrente precisa da mesma postura e do mesmo conjunto de acesso. Se muda tudo a cada pedido, talvez seja só uma conversa com boa instrução. Agente começa a valer quando o papel fica estável.

Squad

Squad é mais de um agente trabalhando na mesma tarefa, com papéis distintos. Um pesquisa, outro implementa, outro revisa. A ideia é separar responsabilidades que brigam quando ficam na mesma cabeça.

Quando preciso disso? Quando a tarefa tem partes independentes ou precisa de tensão real entre papéis. Para coisa pequena, squad só aumenta coordenação. O degrau existe, mas não é o primeiro.

A pergunta que fecha quase todos os diagnósticos é: o que eu estou tentando fazer agora: dar contexto, seguir um procedimento, usar uma ferramenta ou chamar um papel especializado? Ela evita o erro comum de pedir ao modelo uma coisa que deveria estar num arquivo.

Para começar pelo degrau certo, o trabalho é o mesmo de sempre: escrever o arquivo de contexto antes de qualquer outra coisa.

Onde isso quebra

A escada convida a subir cedo demais. Quase todo mundo que quer montar um squad ainda não escreveu o arquivo de contexto. Aí cria vários agentes, cada um com um nome bonito, e todos devolvem versões diferentes da mesma resposta genérica.

O custo real é coordenação antes de substância. Sem contexto, skill vira ritual vazio, ferramenta vira botão sem critério, agente vira persona, e squad vira reunião. Comece pelo degrau chato. Escreva a base antes de pedir que o sistema aja como time.

Trabalho com times que estão adotando agentes de IA no dia a dia de engenharia. Se isso é o seu caso, vamos conversar.

Ver consultoria
Modelo, contexto, skill, ferramenta, agente, squad | Hugo Minari Diniz