VHK - harness completo de codificação com IA que não desmorona mesmo trocando de modelo ou agente

Quando você faz vibe coding, acaba trocando de ferramenta com frequência. Usa Claude Code, depois Cursor, depois Codex... E, a cada troca, os arquivos de regras e o contexto ficam espalhados, e o agente diz "está tudo pronto", mas na prática muitas vezes nem os testes rodaram. Criei este harness CLI porque não queria ter que organizar isso manualmente toda vez.

O VHK não é um agente de codificação. Independentemente do agente que você usar, ele fica por cima e fixa regras, especificações, evidências e memória dentro do repositório. Mesmo que você troque o modelo inteiro, esses arquivos continuam lá.

Principais recursos

• Sincronização de regras: gerenciando apenas um RULES.md, ele ajusta automaticamente 8 arquivos de regras de ferramentas, como .cursorrules, CLAUDE.md e copilot-instructions.
• Gate de evidências: verify / review / receipt / preflight. Em especial, receipt detecta "conclusões falsas" com evidências mecânicas, como códigos de saída de tsc, test e build (sem usar LLM no julgamento).
• Autoevolução: as lições acumuladas em cada sessão são reunidas em memory/pattern e promovidas como candidatas a regras. Quanto mais você usa, mais ele se ajusta a este projeto.
• Ciclo completo: vai da validação da ideia ao desenvolvimento, verificação e até rascunhos de conteúdo, operação e vendas após o deploy, tudo conectado por comandos (publicação e pagamento ficam com humanos).
• Linguagem natural em coreano: também faz roteamento em coreano, como em vhk 저장해줘 e vhk 출고점검.

A proposta não é substituir agentes, mas assumir as partes em que eles costumam falhar: repetição, memória e gates.

Sendo bem sincero, é um projeto solo, então o foco ainda é coreano, e a documentação em inglês ainda está correndo atrás. Se houver partes meio brutas, fiquem à vontade para comentar.

Instalação: npm i -g @byh3071/vhk
GitHub: https://github.com/byh3071-cpu/vhk (MIT · MCP 35 tools · Node 22+)

Fui fazendo sozinho e já cheguei à v2.9.0. Se o seu projeto balança toda vez que você troca de modelo, feedback é muito bem-vindo.