Toolkits · Harness engineering

Harness engineering,
em uma janela, não em um dotfile

O que um agente pode fazer é decidido pelo seu harness: a persona, as ferramentas e a memória. O AgentsRoom transforma isso em três controles separados que você combina por agente e por tarefa.

Um toolkit agrupa skills, servidores MCP, conexões salvas e variáveis de ambiente sob um único nome. Anexe-o a um agente, a um único ticket, a uma etapa de equipe, a um projeto ou à pasta de um cliente. Edite uma vez e cada agente que o usa recebe a mudança na próxima inicialização, no Claude Code, no Codex e em qualquer outra CLI de agente.

Harness de um agente
PersonaRevisor de código
ToolkitPesquisa
  • scan-documents
  • summarize
  • notes (MCP)
  • staging-db
Memória do projetoApenas leitura
Na inicialização
  • Claude Code
  • Codex
  • Antigravity
  • Cursor

Um toolkit de pesquisa anexado a um ticket: o agente recebe as skills, o servidor MCP e a conexão dele na inicialização, e lê a memória do projeto sem escrever nela.

Harness engineering (projetar tudo o que cerca um agente de código) é decidir quais instruções ele lê, quais ferramentas pode chamar e qual conhecimento guarda. Hoje quase tudo isso mora em arquivos. Um CLAUDE.md aqui, um mcp.json ali, uma pasta de skills para cada CLI, variáveis de ambiente no perfil do shell, e nada disso chega ao próximo agente ou à próxima tarefa sem ser copiado à mão.

No AgentsRoom, um agente são três coisas que você define separadamente. A persona diz quem ele é. Os toolkits dizem o que ele pode usar: skills, servidores MCP, conexões SSH, de banco de dados e de comandos de dev salvas, variáveis de ambiente. A configuração de memória diz se ele lê e escreve a memória compartilhada do projeto. Você muda uma sem mexer nas outras duas.

Um toolkit é anexado por referência, nunca copiado. Um toolkit de pesquisa com uma skill que analisa documentos, outra que resume e uma conexão com o seu app de notas pode equipar ao mesmo tempo um agente revisor, um único ticket e a pasta inteira de um cliente, e qualquer melhoria nele chega a todos.

Três controles em vez de uma única definição de agente

Dê capacidades a uma tarefa sem persona, mantenha uma persona sem memória ou reutilize as mesmas ferramentas com papéis diferentes.

Skills, servidores MCP e conexões em um único toolkit

Escolha skills da sua biblioteca e conexões SSH, de banco de dados e de comandos de dev salvas, cole o JSON de servidores MCP que você já usa e adicione variáveis de ambiente. As credenciais ficam no Gerenciador de segredos como referências {{secret:NAME}}, resolvidas no seu computador na inicialização.

Anexado por referência

Agentes, tickets e configurações guardam o toolkit, não uma cópia do conteúdo dele. Edite o toolkit uma vez e cada agente que o usa recebe as novas skills e servidores na próxima inicialização.

Em todos os níveis que você já usa

Anexe um toolkit a um agente, a um agente salvo, a um único ticket do backlog, a uma etapa de uma equipe de agentes, a um projeto inteiro ou à pasta de um cliente, cujas subpastas adicionam os próprios toolkits.

Capacidades para uma única tarefa

Um ticket pode trazer os próprios toolkits sem mudar o agente. Eles se somam aos do agente, ou substituem tudo (agente, projeto e pasta) quando o modo Skills do ticket está em Substituir.

Memória, separada da persona

Defina a memória do projeto como Desativada, Apenas leitura ou Leitura e escrita por agente, e mude isso para um único ticket. Apenas leitura mantém a base de conhecimento disponível sem deixar um agente de revisão reescrevê-la.

Todas as CLIs de agente, no desktop e no celular

As skills chegam a cada CLI como texto e, no Claude Code e no Antigravity, como skills nativas. Os servidores MCP são escritos no formato próprio de cada CLI. Crie e anexe toolkits pelo desktop ou pelo app móvel, ou deixe um agente fazer isso com as ferramentas do AgentsRoom.

Monte um toolkit em menos de um minuto

Nenhum arquivo para editar e nada para reiniciar à mão.

  1. 1

    Abra a biblioteca

    Clique na maleta ao lado de Agentes na barra de título, ou em Gerir ao lado de qualquer campo Toolkits, e depois em Novo toolkit.

  2. 2

    Preencha

    Dê um nome, escolha as skills e as conexões, cole os servidores MCP e adicione as variáveis de ambiente. Use {{secret:NAME}} para um token.

  3. 3

    Anexe

    Em Editar agente > Opções avançadas > Toolkits, em um ticket, em uma etapa de equipe, em Definições do projeto > Capacidades e permissões ou em Definições da pasta > Conhecimento.

  4. 4

    Escolha a memória

    Logo abaixo dos toolkits, defina Memória do projeto como Desativada, Apenas leitura ou Leitura e escrita, ou deixe herdada.

  5. 5

    Inicie

    A próxima inicialização do agente expande o toolkit na CLI dele: skills, servidores, conexões e variáveis, sem escrever nada no seu repositório.

Por que separar persona, ferramentas e memória

Até agora, uma definição de agente carregava tudo de uma vez. Reutilizar um conjunto de skills e servidores com outro papel exigia refazê-lo, e o único jeito de manter um agente longe da memória do projeto era tirar a persona dele com o prompt de sistema mínimo.

Separados, os três controles respondem a situações reais: um revisor que lê a memória mas nunca escreve nela, um ticket pontual de pesquisa que precisa de um servidor de notas que o agente não tem, a pasta de um cliente em que todos os agentes precisam acessar o mesmo banco de dados de staging, uma etapa de equipe que usa um toolkit de navegador só durante a sua vez.

É também a porta de entrada para o harness engineering para quem não quer manter dotfiles: cada escolha fica visível na janela do agente, acompanha a sua conta nos seus outros computadores e pode ser conferida em um piscar de olhos.

Bom saber

  • Uma mudança vale a partir da próxima inicialização do agente. Uma sessão que já está rodando mantém o que tinha ao começar.
  • Uma skill ou conexão de projeto dentro de um toolkit só vale no próprio projeto. As skills da conta valem em todo lugar.
  • Os toolkits pertencem à sua conta. Em uma equipe compartilhada com colegas, a inicialização de cada pessoa só resolve os toolkits dela.
  • Uma etapa de equipe tem toolkits, mas não tem configuração de memória: use a opção Passo em modo só de leitura em uma etapa que não deve escrever nada.
  • Até 20 toolkits por agente, ticket, etapa, projeto ou pasta, e 200 por conta.
  • Um agente rodando em uma máquina remota via SSH recebe as skills do toolkit, mas não os servidores MCP dele.

Perguntas frequentes

O que é harness engineering?

É a prática de moldar o ambiente de um agente de código, e não só o prompt: as instruções que ele carrega, as ferramentas e servidores MCP que pode chamar, o conhecimento que lê e escreve. O AgentsRoom expõe essas peças como três controles (persona, toolkits, memória) que você define por agente e por tarefa.

Posso reutilizar as mesmas skills e servidores MCP em vários agentes?

Sim. Coloque-os em um toolkit e anexe-o a cada agente, ou ao projeto ou à pasta para que todos os agentes de lá o recebam. Editar o toolkit atualiza todos eles na próxima inicialização.

Um único ticket pode receber um servidor MCP que o agente dele não tem?

Sim. Anexe um toolkit ao ticket. A execução o recebe além dos toolkits do próprio agente, e a configuração salva do agente não muda.

Como impedir um agente de escrever na memória do projeto sem perder a persona dele?

Defina a Memória do projeto dele como Apenas leitura, ou Desativada para esconder a memória por completo. A persona e as ferramentas continuam como estão. Você também pode definir isso só para um ticket.

Funciona com o Codex e as outras CLIs de agente, ou só com o Claude Code?

Com todas as CLIs de agente que o AgentsRoom inicia. As skills chegam como texto em todo lugar e como skills nativas no Claude Code e no Antigravity, os servidores MCP são escritos no formato de configuração próprio de cada CLI, e as conexões e variáveis acompanham o agente qualquer que seja a CLI.

Onde meus tokens ficam guardados?

Nunca no próprio toolkit. Um toolkit guarda referências {{secret:NAME}} ao Gerenciador de segredos, e o valor é resolvido no seu computador quando o agente inicia.

Meus agentes podem criar toolkits para mim?

Sim, quando você pede. As ferramentas do AgentsRoom incluem toolkits_list, toolkits_get, toolkits_save e toolkits_delete, e agents_save, os tickets do backlog, as etapas de equipe e as configurações de projeto ou de pasta aceitam uma lista de toolkits. Os agentes são orientados a nunca criar um para dar acesso a si mesmos.

Você também pode gostar

Workflow multi-agente • Handoff • Loop de feedback

O AgentsRoom Agent Teams encadeia agentes de código IA como uma equipa de engenharia de verdade. Editor visual de workflows (canvas estilo n8n) para ligar os papéis Dev, QA, PM, Segurança e DevOps. Handoff automático com resumo, diff do git, riscos e dicas de teste. Portões de qualidade verificados pela máquina (quem decide é a tua suite de testes, não o agente), ramos paralelos de revisão QA e Segurança, ligações condicionais, loops de feedback, teto de ciclos. Escolhe, equipa a equipa, como os papéis correm: um agente que faz morph de papel em papel e guarda todo o contexto, ou um agente vivo por papel, a trocarem mensagens em tempo real. O orquestrador multiagente que faltava aos teus agentes em Claude, Codex, GitHub Copilot CLI, Cursor e outras 13 CLIs de agentes.

Servidores MCP

Declare um servidor MCP uma única vez e entregue-o ao Claude Code, ao Codex e a cada CLI de agente. Escolha-o no registro MCP oficial, guarde as chaves no Gerenciador de segredos e faça login em servidores OAuth como Notion ou Linear com um único botão Conectar.

Project Memory

Dê aos seus agentes de codificação IA uma memória de longo prazo. Decisões, arquitetura e armadilhas persistem entre as sessões e são compartilhadas com todos no projeto. Grátis, ilimitado.

Personalize Agentes

Escolha entre 14 papéis de agente integrados, adicione agentes especialistas da The Agency ou crie seu próprio agente de codificação AI personalizado com seu próprio prompt de sistema. Em seguida, compartilhe seus agentes com sua equipe através do chat e publique-os na comunidade para que todos evoluam juntos.

Gerenciador de segredos

Armazene chaves de API, tokens e senhas no chaveiro do seu sistema operacional, referencie-os como {ref} nos comandos de dev e nos ambientes dos agentes, e deixe o AgentsRoom resolvê-los na inicialização. Os agentes veem os nomes, nunca os valores, e nada é sincronizado com um servidor.

Equipe seus agentes uma única vez

Grátis no macOS, Windows e Linux, com o app móvel para gerenciar toolkits pelo celular.

GrátisBaixar AgentsRoom

App complementar: acompanhe seus agentes em qualquer lugar

Use Claude, Codex, Antigravity CLI ou outro provedor de IA.

Instalar a extensão
Chrome Web Store

Envie bugs e pedidos direto para o seu backlog público.

Multi-projetos
Multi-provedor
Multi-agentes
Status ao vivo
Diff e commit
App mobile
Preview ao vivo
Equipes de agentes
Testes no navegador
Dev guiada por backlog
Biblioteca de prompts
Biblioteca de skills
Ver todas as funcionalidades