Ir para o conteúdo
Promovaweb

Configure o Herdr e grave as instruções do projeto

StayCloudVPS Agêntica

Uma VPS para os seus agentes trabalharem dia e noite

Instale o SetupVibe Desktop numa VPS da StayCloud em São Paulo, com acesso root e disco NVMe. Deixe Claude Code, Codex e OpenCode rodando no tmux ou no Herdr e feche o notebook sem interromper nada.

Montar minha VPS Agêntica

Link de parceiro da Promovaweb.

Black Friday até 30/11

30%off

nos 2 primeiros meses do plano mensal da VPS

  • Backup diário grátis para sempre
  • Servidores em São Paulo no datacenter da Ascenty
  • Datacenter Tier III manutenção sem parada
  • Acesso root com disco SSD NVMe
  • Réplica do backup em Ashburn, nos EUA

O método só rende quando o próximo agente também o conhece, então o Herdrfy confere a instalação, mostra o que falta e grava o bloco de instruções no AGENTS.md e no CLAUDE.md do projeto. A partir daí, cada agente aberto na pasta segue o mesmo acordo, sem você repetir a explicação.

Nesta página
  1. A instalação que ninguém terminou
  2. As integrações que dão estado ao agente
  3. O bloco que ensina o próximo agente
  4. Por que gravar em vez de explicar
  5. Atualizar, conferir e remover
  6. O resultado no dia seguinte

A instalação que ninguém terminou

Uma skill instalada num projeto não configura a máquina, porque faltam os binários do Herdr, as integrações que informam o estado de cada agente, os templates que guardam o comando completo e o bloco de instruções que os próximos agentes leem. Cada item ausente vira uma surpresa no meio do trabalho. O diagnóstico encontra cada um desses itens antes do primeiro painel.

O Herdrfy começa pela conferência, porque o agente recebe a lista de binários, servidores e integrações. A lista segue com skills, templates e agentes, além das pendências e do comando que resolve cada uma. Você vê o estado real antes de instalar ou alterar qualquer coisa, o que evita uma mudança sem motivo.

A instalação de um binário e a mudança num arquivo de configuração aguardam a sua confirmação, salvo quando a instrução já for essa. O diagnóstico não altera a sua máquina.

Abra o guia de configuração para conferir o seu ambiente. O guia mostra a saída do diagnóstico e o que cada pendência exige.

As integrações que dão estado ao agente

As integrações contam ao Herdr TUI o estado e a sessão de cada agente, porque sem elas o TUI vê um terminal e não sabe se o agente está trabalhando, parado ou esperando uma resposta. A skill instala a integração de Claude Code, Codex e OpenCode. Os agentes que já estavam abertos precisam ser reiniciados para carregar a integração.

No Desktop, os templates do herdr-core guardam o comando de cada agente com as permissões liberadas. O projeto traz três templates, um para cada agente principal. Com o template copiado, iniciar um agente fica menor e o comando completo fica registrado.

Consulte as integrações por agente no guia de configuração. A página mostra a ordem de instalação e o que reiniciar depois.

O bloco que ensina o próximo agente

Um agente novo não conhece a skill, então o Herdrfy grava um bloco de instruções no AGENTS.md e no CLAUDE.md. O bloco fica entre dois marcadores e é trocado a cada execução, sem alterar o que você escreveu fora dele.

O conteúdo cobre a localização e o lugar de abertura. Também cobre os comandos completos dos agentes, a leitura antes de agir e a limpeza. É o mesmo método da skill, escrito para o agente que chega depois e precisa trabalhar sem uma explicação sua.

Você pode gravar no projeto atual ou nos arquivos globais dos agentes, pode conferir se o bloco está atualizado e pode remover quando não quiser mais. A gravação é repetível, porque rodar de novo atualiza o bloco e preserva o resto do arquivo.

Grave o bloco no seu projeto pelo guia de configuração, que explica o marcador, a conferência e a remoção.

01MáquinaO Herdr instalado e o diagnóstico sem pendências.
02FerramentaAs integrações e os templates com o comando completo.
03ProjetoO bloco que todo agente novo lê ao abrir a pasta.
A configuração sobe em três camadas e a última é a que mantém o método no dia seguinte.

Por que gravar em vez de explicar

Explicar o método a cada agente consome a sua atenção e abre espaço para variação, porque um agente abre por alias, outro esquece a flag de permissão e um terceiro fecha um painel que não era dele. O bloco no projeto reduz essa variação e mantém o mesmo acordo entre as sessões.

Quando um agente novo encontra o bloco, ele sabe que precisa rodar o localizador antes do primeiro comando do Herdr, que o painel abre na aba de origem da instrução e que a permissão se libera pelo comando completo. A instrução fica escrita no lugar onde o agente procura, não na sua memória.

O bloco também deixa a revisão do projeto mais previsível, porque a mesma instrução vale para o agente e para você. A diferença entre as duas aparece no relato do agente e você escolhe qual fica.

Padronize o projeto com os planos da Promovaweb. As aulas ao vivo e o Co-work acompanham o método em projetos de clientes.

Atualizar, conferir e remover

Depois de atualizar a skill, o bloco do projeto pode ficar velho, então a conferência responde quando o arquivo está desatualizado e a gravação troca só o trecho entre os marcadores. Blocos antigos, com marcadores de versões anteriores, são reconhecidos e regravados.

Se o seu AGENTS.md já tem instruções de Herdr escritas à mão, o script mostra as linhas e pergunta qual fica. A escolha continua com você, porque o script não apaga um texto sem a sua resposta.

Para remover, o script tira o bloco e preserva o resto do arquivo. A skill também aceita a remoção da instalação global. A limpeza é segura porque o bloco fica delimitado pelos marcadores.

Veja o contrato do bloco na referência de instruções, que mostra o conteúdo, a conferência e a remoção.

O resultado no dia seguinte

No dia seguinte, você abre um agente novo na pasta e ele já conhece o método, sem repetir a localização, o comando completo ou a limpeza. O trabalho começa na instrução e não na configuração.

A configuração também deixa o ambiente previsível para a revisão, porque o diagnóstico mostra o que está instalado, o bloco mostra o que o agente deve fazer e o relato mostra o que ele fez. Essas três peças fecham o ciclo.

Comece pelo guia de instalação e siga para a configuração depois de instalar a skill. O diagnóstico vem primeiro e o bloco vem quando o ambiente estiver pronto.

Converse na comunidade

Leve ao Discord da Promovaweb a tarefa que você quer paralelizar e o agente que pretende abrir. A comunidade discute o escopo antes de você entregar o trabalho.

Coloque o método no seu projeto

A documentação mostra a instalação e os comandos por superfície. A Formação Vibe Coding acompanha o trabalho com agentes em projetos reais. Os planos da Promovaweb reúnem aulas ao vivo e Co-work.

Para organizar o escopo e a arquitetura do seu projeto com agentes, conheça o Diagnóstico de Produto e Arquitetura da Dev Side Studio.