Gentle-AI para começar: adicione memória, fluxo de trabalho e evidências a um agente de codificação com IA

Para quem é

Você já usa um agente de codificação com IA e esbarra com a mesma coisa o tempo todo: assim que ele termina de escrever o código, limpa o contexto e a próxima rodada recomeça do zero; ele não tem um julgamento estável sobre o seu projeto; e, quando acaba, a única forma de provar o que ele realmente mudou é você mesmo ler o diff, linha por linha.

O Gentle-AI mira exatamente esse dia a dia. Ele não substitui o seu agente: ele sobrepõe ao agente que você já usa um ambiente de engenharia determinístico, que a documentação oficial resume como "The deterministic engineering environment". Tudo se resume a três coisas: memória, fluxo de trabalho e evidências.

Serve para desenvolvedores que têm um repositório de verdade e querem que o agente guarde por muito tempo as convenções do projeto; para líderes de time que preferem que o agente avance seguindo um processo fixo em vez de improvisar a cada vez; e para situações em que cada alteração precisa deixar um registro conferível, facilitando a colaboração e a passagem de turno.

Ao contrário, ele não resolve o desejo de trocar de editor ou de modelo: o que ele regula é a maneira de trabalhar do seu agente atual, não a ferramenta que você usa. Se for apenas um script descartável e você não precisa de rastreabilidade, avalie primeiro se vale a pena acrescentar mais uma camada de configuração.

Primeiro teste em 3 minutos

Siga apenas o caminho oficial: abra o Quickstart.

https://github.com/Gentleman-Programming/gentle-ai/blob/main/docs/quickstart.md

Pré-requisitos: você já tem instalado um agente compatível (Claude Code, por exemplo) e permite que ele leia e grave no diretório do projeto. O Gentle-AI não fornece agente: ele apenas escreve a configuração no agente que você já tem. A documentação oficial declara 17 integrações, e as diferenças entre agentes ficam registradas em docs/agents.md; essa tabela de comparação também mostra quais capacidades cada agente pode obter.

Antes de começar, dedique um minuto a ler essa tabela e confirme se o agente que você usa no dia a dia está na lista. Se não estiver, troque de agente antes de discutir configuração: contornar isso só rende um ambiente que não instala e cujo efeito você não consegue explicar.

O local de instalação é o diretório de destino indicado na seção do Quickstart do agente que você usa. A página inicial diz apenas que ele faz configuração nativa e não lista os caminhos em disco de cada agente, então não chute diretórios de memória nem copie o caminho de outro agente.

Instalado, não peça logo uma grande reformulação. Dê a ele primeiro uma tarefa somente de leitura: percorrer a estrutura do projeto, explicar como pretende entender o repositório e apresentar um plano antes de mexer em qualquer coisa. Esse passo não grava arquivo nem executa comando, o risco é mínimo. Quando houver gravação de arquivos, execução de shell ou chamadas externas, mande-o listar um a um os arquivos que vai alterar e as ações que vai executar, e só libere depois da sua confirmação.

Há dois sinais de sucesso observáveis: troque de sessão e o agente ainda sabe dizer quais convenções já existiam no seu projeto, o que mostra que a memória foi gravada em disco; e, dentro da mesma sessão, ele segue um processo fixo — primeiro o plano, depois a ação, depois um registro conferível — em vez de apenas devolver uma resposta. A descrição oficial do percurso completo é: um único prompt chega até um commit com resultado de revisão.

Casos de uso

Caso um: um prompt, da ideia até o commit com resultado de revisão. A seção da página inicial do repositório demonstra exatamente essa linha: a memória recupera o contexto do projeto, o fluxo de trabalho restringe os passos e as evidências explicam as mudanças. As evidências param aí — a página inicial mostra essa cadeia, mas sem detalhes de interface passo a passo; a ordem real e os artefatos devem ser conferidos no Quickstart e em docs/intended-usage.md.

Caso dois: acrescentar ao agente memória, fluxo de trabalho e evidências conferíveis. O método é escrever a configuração do agente escolhido conforme o Quickstart; as opções listadas oficialmente incluem memória persistente, skills selecionadas, servidores MCP e personas. Vale observar que a página inicial só dá os nomes desses itens de configuração, sem dizer quais arquivos correspondem a qual agente nem qual prevalece em caso de conflito; isso precisa ser conferido em docs/agents.md e na documentação de cada agente.

O que os dois casos têm em comum: você não precisa trocar o agente que já tem; o que se ganha é apenas lembrar e conseguir explicar. A página inicial não traz dados quantificados de ganho de eficiência ou qualidade, então não espere que ela prove o benefício para você.

Limites de uso

É uma camada de configuração, não um agente novo nem uma IDE: antes de tudo é preciso um agente compatível, para que a configuração tenha onde se apoiar. A documentação oficial declara 17 integrações, e a página inicial cita apenas parte delas; para saber se um editor ou uma ferramenta de linha de comando está na lista, veja a tabela de comparação em docs/agents.md, sem presumir que tudo funciona.

A página inicial descreve a segunda verificação apenas como opcional e de escopo limitado, sem trazer limiares de decisão nem cenários de aplicação: não a trate como uma barreira de qualidade; mudanças importantes continuam exigindo a sua própria revisão.

Detalhes sobre o local de instalação e onde cada item de configuração vai parar estão espalhados pela documentação de cada agente; a página inicial só dá a entrada, então ao copiar caminhos confira a qual agente a seção pertence.

Documentação, site oficial e wiki estão hoje todos em inglês: copie comandos e caminhos exatamente como são, com atenção às maiúsculas e minúsculas. A página inicial do repositório ainda traz duas entradas, para o site oficial e para o wiki, então, diante de uma dúvida de configuração sobre um agente específico, procure primeiro uma resposta pronta nesses dois lugares.