oh-my-harness - CLI gerador de hooks para agentes de codificação com IA

Olá. Enquanto usava Claude Code e Codex, acabei criando um CLI chamado oh-my-harness, um gerador de hooks, depois de ser “traído” pelos prompts (?).

No começo, eu só adicionava instruções em CLAUDE.md ou AGENTS.md, mais ou menos assim.

Corrija os testes primeiro
Execute os testes antes de fazer commit
Não faça commit na branch main
Não mexa em node_modules nem dist
Não modifique .env

Mas, conforme fui usando, ele ignorava a maior parte das instruções e, em algum momento, simplesmente deixava de segui-las.

Em especial, mesmo eu pedindo para desenvolver com TDD,
acabava dizendo
“Desculpe, não corrigi os testes”
ou então,

mesmo eu pedindo para verificar se a branch já tinha sido mergeada, depois de fazer commit e push ele insistia:
“A branch ainda não foi mergeada” (?)

Foi por isso que criei o oh-my-harness.

Ele oferece um CLI para agentes e também uma TUI para pessoas.

omh init "React app with TDD"  

Ou

omh init  

Aí ele analisa o projeto, cria um harness.yaml e, com base nisso, também gera o CLAUDE.md para Claude Code, o AGENTS.md para Codex e as configurações de hooks de cada runtime.

Por exemplo, no momento ele consegue bloquear ou verificar coisas como estas.

• Bloquear tentativas de commit na main ou em branches que já foram mergeadas
• Executar testes ou checagem de tipos antes do commit
• Bloquear pela regra de TDD quando alguém tenta modificar só o código-fonte sem antes corrigir os testes
• Proteger arquivos/pastas como node_modules, dist, .next e .env
• Filtrar comandos de shell perigosos

Tudo isso funciona com um conjunto de scripts de shell prontos, que eu chamo de catálogo.

O omh init tem o papel de escolher os catálogos adequados com base na linguagem natural recebida.

Pessoalmente, ao usar ferramentas de codificação com IA, senti que, mais do que dizer “conto com você”, é muito mais importante ter um dispositivo de segurança que interrompa tudo imediatamente quando houver um erro.

Principalmente à medida que os agentes passam a alterar cada vez mais arquivos e o fluxo até o commit se torna mais natural, achei que esse tipo de mecanismo vai se tornar ainda mais necessário.

———

Instalação: npm install -g oh-my-harness

GitHub: https://github.com/kyu1204/oh-my-harness

npm: https://www.npmjs.com/package/oh-my-harness

Ainda está no começo, então há muitas partes que precisam melhorar.
Experimentem e mandem bastante feedback. Contribuições também são muito bem-vindas!