aibenyclaude-coder/tetra-scar

O que tetra-scar faz?

Memória de Scar e arco reflexo para agentes de IA. Aprenda com falhas permanentemente. Bloqueie erros repetidos instantaneamente — sem necessidade de chamadas LLM.

Visão Geral

Este skill implementa um sistema de aprendizado por reforço negativo para agentes de IA. Ele permite que o agente:

• Registre falhas de forma estruturada, incluindo contexto, ação e consequência.
• Armazene cicatrizes (scars) em uma memória persistente, garantindo que o aprendizado seja duradouro.
• Ative um reflexo que bloqueia ações que levariam a erros já conhecidos, sem consultar o modelo de linguagem.

Como Funciona

1. Detecção de falha: Quando o agente executa uma ação e obtém um resultado indesejado (e.g., erro de compilação, timeout, saída incorreta), o skill é acionado.

2. Criação de cicatriz: Uma cicatriz é criada contendo:

   • O contexto anterior à ação (e.g., estado do ambiente, comandos recentes).
   • A ação executada (comando executado ou decisão tomada).
   • O resultado falho (mensagem de erro, exceção).
   • Um identificador único da sequência.

3. Aprendizado reflexo: O skill atualiza uma tabela de reflexos que mapeia padrões de contexto para ações proibidas. Esse mapeamento é feito de forma eficiente, sem necessidade de inferência LLM.

4. Bloqueio instantâneo: Em iterações futuras, antes de executar qualquer ação, o agente verifica o reflexo. Se o contexto atual corresponder a um padrão de cicatriz, a ação é bloqueada e o agente é redirecionado para uma ação alternativa segura.

Plataformas Suportadas

• Claude Code (via Anthropic API)
• Cursor (IDE com IA)
• Codex (extensão de terminal)
• Qualquer agente que suporte hooks de pré/pós-execução

Instalação

Adicione o skill ao seu arquivo de configuração do agente. Exemplo:

{
  "skills": [
    {
      "type": "aibenyclaude-coder/tetra-scar",
      "config": {
        "storage": "local",
        "max_scars": 100,
        "reflex_threshold": 0.8
      }
    }
  ]
}

Uso

Registro Manual de Falha

Você pode invocar o skill diretamente com:

scar --record "contexto: executando build" --action "npm run build" --error "dependency missing: react"

Consulta de Reflexos Ativos

scar --list-scars

Limpeza de Cicatrizes

scar --clear --all

Importante: A limpeza remove o aprendizado permanente. Use com cautela.

Exemplo de Fluxo

1. O agente tenta instalar um pacote com pip install torch e falha devido à dependência ninja ausente.

2. O skill cria uma cicatriz:

   Context: [ "pip install torch" ]
   Action: "pip install torch"
   Error: "ModuleNotFoundError: No module named 'ninja'"
   

3. Quando o agente novamente tenta pip install torch, o reflexo bloqueia: "Ação bloqueada: pip install torch (erro conhecido: ninja ausente)". O agente então tenta conda install torch como alternativa.

Configuração

Parâmetro	Tipo	Padrão	Descrição
storage	string	local	Tipo de armazenamento (local, redis)
max_scars	integer	100	Número máximo de cicatrizes armazenadas
reflex_threshold	float	0.8	Similaridade mínima para ativar o reflexo

Limitações

• O reflexo é baseado em correspondência exata ou vetorial simples; não substitui aprendizado por reforço complexo.
• Cicatrizes não são enviadas para servidores externos (privacidade dos dados).
• A eficácia depende da qualidade do contexto capturado.

Licença

MIT