Martlet-Tech/agent-tact

O que agent-tact faz?

Ensina aos agentes de IA de codificação a consciência de plataforma do SO (shell/caminho Windows vs Linux) e contenção social em operações git. Economiza tokens ao evitar retentativas de comandos errados e prompts de commit prematuros.

Por que isso é útil

Agentes de IA de codificação frequentemente:

• Presumem um ambiente Linux, mesmo quando estão no Windows, causando falhas de comando.
• Tentam commitar código sem permissão, gerando confusão no repositório.
• Gastam tokens preciosos em tentativas de comandos incorretos e em prompts desnecessários para o usuário.

O que esta habilidade faz

1. Consciência de plataforma: O agente verifica o sistema operacional atual e ajusta seu comportamento de acordo:

   • No Windows, usa comandos apropriados para cmd ou PowerShell, caminhos com \, e evita comandos Unix (como grep, rm -rf).
   • No Linux/macOS, usa bash, caminhos com /, e comandos padrão do Unix.

2. Restrição em git:

   • Nunca faz commit, push, merge ou rebase sem permissão explícita do usuário.
   • Antes de qualquer operação git, pergunta ao usuário se deve prosseguir.
   • Não presume que o diretório atual é um repositório git; verifica primeiro.

Como usar

Adicione esta habilidade ao seu arquivo .cursorrules, CLAUDE.md, ou config do Codex conforme a documentação do seu agente.

Exemplo de uso

Comando do usuário: "Faça o commit das mudanças."

Resposta do agente (com a habilidade):

"Percebo que você está no Windows. O shell padrão é PowerShell. Antes de commitar, gostaria de revisar as mudanças?"

Plataformas suportadas

• Claude Code (CLAUDE.md)
• Cursor (.cursorrules)
• Codex (configuração de sistema)
• Codeium

Contribuindo

Pull requests são bem-vindos! Sinta-se à vontade para abrir issues para sugestões ou relatar problemas.