Repolode
Enviar
m0n0x41d

m0n0x41d/haft

Camada local de governança que dá a agentes de programação com IA uma memória duradoura do projeto: problemas, opções comparadas, decisões humanas, evidências e desatualização.

Ver no GitHubSite
Estrelas
1,395
Forks
103
Issues abertas
14
Último commit
mês passado

O que é?

Haft é uma camada local de governança para agentes de programação com IA, como Claude Code e Codex. Ela registra qual problema o projeto está resolvendo, quais opções foram comparadas, quais decisões uma pessoa tomou e quais evidências as sustentam. Raciocínios pequenos e reversíveis podem ficar no chat, enquanto resultados dos quais trabalhos futuros dependem se tornam registros tipados do projeto em um grafo local de artefatos `.haft/`.

Haft é baseado no First Principles Framework (FPF). Ele inclui o código-fonte versionado do FPF no contexto de trabalho do agente e adiciona skills locais do projeto, mecanismos de controle via MCP e uma memória com backend SQLite. Seu kernel valida no servidor os campos obrigatórios e as lacunas de paridade, e as evidências perdem validade com o tempo, trazendo para revisão afirmações desatualizadas e divergências no código. Os agentes podem estruturar, comparar e preparar registros, mas decisões vinculantes e comissões de execução exigem o operador humano.

A ferramenta é usada por meio de skills, de uma CLI (`haft artifact`, `haft decision`, `haft spec` e outros) e de um servidor MCP (`haft serve`). Ela oferece integrações de inicialização para Claude Code e Codex como hosts estáveis, enquanto Cursor, Gemini CLI e vários outros são listados como adaptadores experimentais ou legados.

Recursos principais

  • 01Armazena problemas, opções comparadas, decisões e evidências como registros tipados do projeto
  • 02Validação via MCP no kernel de campos obrigatórios, lacunas de paridade e evidências ausentes
  • 03Desgaste da atualidade das evidências, que sinaliza afirmações desatualizadas e divergências para revisão
  • 04Consultas ao grafo de código que mostram quais decisões regem um arquivo ou símbolo
  • 05Comandos de consulta, busca e inspeção do FPF nativos à fonte
  • 06Integrações de inicialização para Claude Code e Codex com seções de instruções gerenciadas

Casos de uso

  • Registrar por que uma escolha arquitetural foi feita para que trabalhos futuros possam se basear nela
  • Diagnosticar uma falha com várias hipóteses em paralelo e manter o resultado para transferência a outra pessoa
  • Verificar se uma decisão técnica anterior ainda se sustenta diante das medições atuais
  • Manter alterações em uma base de código compartilhada, feitas com ajuda de IA, vinculadas à autoridade humana explícita

Início rápido

  1. 1

    Execute o script oficial de instalação indicado no README

  2. 2

    Inicialize o projeto para o seu agente (o exemplo mostra Claude Code; consulte o README para outros hosts)

    haft init --claude
  3. 3

    Reinicie ou reconecte seu agente de programação; depois, use-o normalmente e chame /h-reason quando necessário

Antes de usar

  • A licença não está claramente identificada (os metadados informam NOASSERTION), então confira a licença do repositório antes de usá-lo.
  • Somente Claude Code e Codex são hosts estáveis; as outras integrações de agentes são experimentais ou legadas.
  • O sidecar opcional de embeddings pode usar cerca de 1-2 GB de RAM quando aquecido.

Em coleções

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

Tópicos

#ai-agents#ai-coding#project-memory#decision-records#mcp#claude-code#codex#spec-driven-development#anthropic#claude

Perguntas frequentes

O que é haft?
Camada local de governança que dá a agentes de programação com IA uma memória duradoura do projeto: problemas, opções comparadas, decisões humanas, evidências e desatualização. Haft é uma camada local de governança para agentes de programação com IA, como Claude Code e Codex. Ela registra qual problema o projeto está resolvendo, quais opções foram comparadas, quais decisões uma pessoa tomou e quais evidências as sustentam. Raciocínios pequenos e reversíveis podem ficar no chat, enquanto resultados dos quais trabalhos futuros dependem se tornam registros tipados do projeto em um grafo local de artefatos `.haft/`.
haft é gratuito? Qual é a licença?
haft é open source sob a licença Other. Confira os termos da licença antes de usá-lo em produtos comerciais.
haft ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de haft foi em 28 de set. de 2026.
Para que posso usar haft?
Registrar por que uma escolha arquitetural foi feita para que trabalhos futuros possam se basear nela Diagnosticar uma falha com várias hipóteses em paralelo e manter o resultado para transferência a outra pessoa Verificar se uma decisão técnica anterior ainda se sustenta diante das medições atuais Manter alterações em uma base de código compartilhada, feitas com ajuda de IA, vinculadas à autoridade humana explícita
Como instalar haft?
Execute o script oficial de instalação indicado no README Inicialize o projeto para o seu agente (o exemplo mostra Claude Code; consulte o README para outros hosts): haft init --claude Reinicie ou reconecte seu agente de programação; depois, use-o normalmente e chame /h-reason quando necessário
Onde consigo haft?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/m0n0x41d/haft

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

Projetos relacionados