Repolode
Enviar
coldteadotai

coldteadotai/abide

Faz cumprir as regras de instrução para agentes de IA do projeto, verificando cada edição e turno com um modelo de decisão e pedindo ao agente que corrija violações.

Ver no GitHub
Estrelas
623
Forks
47
Issues abertas
5
Último commit
há 27 dias

O que é?

Abide é uma ferramenta para agentes de programação como Claude Code, Codex, OpenCode e Pi. Arquivos de instrução do projeto, como AGENTS.md ou CLAUDE.md, contêm regras que linters não conseguem verificar, por exemplo: "nunca deixe um erro bruto chegar ao usuário". Abide transforma cada regra em uma pergunta e consulta Jev, o modelo de decisão da TypeSafe, para obter uma probabilidade após cada edição ou no fim de um turno. Jev vê apenas a regra e o diff, não a conversa.

Quando a pontuação de uma regra é alta o suficiente, o agente recebe a informação de qual regra foi violada e corrige o código no mesmo turno. Pontuações moderadas exibem uma nota para o usuário sem acionar uma correção. As regras ficam em um arquivo legível e versionado, .abide/rubric.json, para que vereditos incorretos possam ser corrigidos reformulando a regra. Os comandos permitem auditar arquivos existentes, verificar alterações não commitadas e reproduzir sessões anteriores.

A configuração é feita com npx e uma chave do TypeSafe ou do Vercel AI Gateway. Os hooks são instalados para cada agente ou no projeto, para que os colegas de equipe os recebam ao fazer checkout.

Recursos principais

  • 01Verifica cada edição ou turno em relação a cada regra dos arquivos de instrução.
  • 02Informa qual regra foi violada e pede ao agente que corrija o código no mesmo turno.
  • 03Armazena as regras em um arquivo de rubrica legível e versionado.
  • 04Oferece suporte a Claude Code, Codex, OpenCode e Pi.
  • 05Audita arquivos existentes e verifica alterações não commitadas pela linha de comando.
  • 06Permite definir o escopo das regras com globs de arquivos e excluir arquivos usando .abideignore.

Casos de uso

  • Fazer cumprir convenções que linters não conseguem verificar, como o uso obrigatório de bibliotecas de validação ou padrões de tratamento de erros.
  • Impedir que agentes adicionem abstrações desnecessárias ou criem arquivos grandes demais durante sessões longas de programação.
  • Auditar uma base de código existente em relação às instruções documentadas.
  • Compartilhar um conjunto de regras para agentes com a equipe por meio do checkout do projeto.

Início rápido

  1. 1

    Armazene sua chave do TypeSafe ou do Vercel AI Gateway

    npx @coldtea/abide login
  2. 2

    Instale os hooks em todos os agentes desta máquina

    npx @coldtea/abide init
  3. 3

    Inicie seu agente (claude, codex, opencode ou pi) como de costume

Antes de usar

  • As verificações exigem uma chave de API do TypeSafe ou do Vercel AI Gateway e acesso à rede.
  • No Codex, é necessário fazer uma etapa manual em /hooks para aceitar as novas entradas de hooks.

Em coleções

Ferramentas, skills e plugins para Claude CodeFrameworks e apps de agentes de IA open sourceAssistentes e agentes de programação com IA

Tópicos

#ai-agent#coding-agent#claude-code#llm#code-review#linting#developer-tools#claude-code-hooks#claude-code-plugin#claude-code-plugins

Perguntas frequentes

O que é abide?
Faz cumprir as regras de instrução para agentes de IA do projeto, verificando cada edição e turno com um modelo de decisão e pedindo ao agente que corrija violações. Abide é uma ferramenta para agentes de programação como Claude Code, Codex, OpenCode e Pi. Arquivos de instrução do projeto, como AGENTS.md ou CLAUDE.md, contêm regras que linters não conseguem verificar, por exemplo: "nunca deixe um erro bruto chegar ao usuário". Abide transforma cada regra em uma pergunta e consulta Jev, o modelo de decisão da TypeSafe, para obter uma probabilidade após cada edição ou no fim de um turno. Jev vê apenas a regra e o diff, não a conversa.
abide é gratuito? Qual é a licença?
abide é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
abide ainda é mantido?
Manutenção ativa. O último commit de abide foi em 10 de out. de 2026.
Para que posso usar abide?
Fazer cumprir convenções que linters não conseguem verificar, como o uso obrigatório de bibliotecas de validação ou padrões de tratamento de erros. Impedir que agentes adicionem abstrações desnecessárias ou criem arquivos grandes demais durante sessões longas de programação. Auditar uma base de código existente em relação às instruções documentadas. Compartilhar um conjunto de regras para agentes com a equipe por meio do checkout do projeto.
Como instalar abide?
Armazene sua chave do TypeSafe ou do Vercel AI Gateway: npx @coldtea/abide login Instale os hooks em todos os agentes desta máquina: npx @coldtea/abide init Inicie seu agente (claude, codex, opencode ou pi) como de costume
Onde consigo abide?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/coldteadotai/abide

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados