Repolode
Enviar
m0n0x41d

m0n0x41d/haft

Capa de gobernanza local que proporciona a los agentes de programación con IA una memoria duradera del proyecto sobre problemas, opciones comparadas, decisiones humanas, evidencias y obsolescencia.

Ver en GitHubSitio web
Estrellas
1,395
Forks
102
Issues abiertos
14
Último commit
el mes pasado

¿Qué es?

Haft es una capa de gobernanza local para agentes de programación con IA, como Claude Code y Codex. Almacena qué problema resuelve un proyecto, qué opciones se compararon, qué decisiones tomó una persona y qué evidencias las respaldan. El razonamiento pequeño y reversible puede quedarse en el chat, mientras que los resultados de los que dependerá el trabajo posterior se convierten en registros tipados del proyecto dentro de un grafo local de artefactos .haft/.

Haft se basa en First Principles Framework (FPF). Incorpora el código fuente versionado de FPF al contexto de trabajo del agente y añade skills locales al proyecto, controles MCP y una memoria respaldada por SQLite. Su kernel valida en el servidor los campos obligatorios y las brechas de paridad, y las evidencias pierden vigencia con el tiempo para que las afirmaciones obsoletas y las discrepancias con el código se señalen para revisión. Los agentes pueden plantear, comparar y preparar registros, pero las decisiones vinculantes y las órdenes de ejecución requieren la intervención humana.

La herramienta se utiliza mediante skills, una CLI (haft artifact, haft decision, haft spec, entre otros) y un servidor MCP (haft serve). Incluye integraciones de inicialización para Claude Code y Codex como hosts estables, mientras que Cursor, Gemini CLI y varios más figuran como adaptadores experimentales o heredados.

Funciones clave

  • 01Almacena problemas, opciones comparadas, decisiones y evidencias como registros tipados del proyecto
  • 02Validación MCP desde el kernel de campos obligatorios, brechas de paridad y evidencias faltantes
  • 03Pérdida de vigencia de las evidencias para señalar afirmaciones obsoletas y discrepancias para su revisión
  • 04Consultas al grafo de código que muestran qué decisiones rigen un archivo o símbolo
  • 05Comandos nativos de FPF para consultar, buscar e inspeccionar
  • 06Integraciones de inicialización para Claude Code y Codex con secciones de instrucciones gestionadas

Casos de uso

  • Registrar por qué se tomó una decisión de arquitectura para que el trabajo posterior pueda basarse en ella
  • Diagnosticar un fallo con varias hipótesis en paralelo y conservar el resultado para transferirlo a otras personas
  • Comprobar si una decisión técnica anterior sigue siendo válida según las mediciones actuales
  • Vincular los cambios en una base de código compartida asistidos por IA con una autoridad humana explícita

Inicio rápido

  1. 1

    Ejecuta el script oficial de instalación del README

  2. 2

    Inicializa el proyecto para tu agente (se muestra Claude Code; consulta el README para otros hosts)

    haft init --claude
  3. 3

    Reinicia o vuelve a conectar tu agente de programación; después, úsalo con normalidad y llama a /h-reason cuando lo necesites

Antes de usarlo

  • La licencia no está claramente identificada (los metadatos indican NOASSERTION), así que comprueba la licencia del repositorio antes de usarlo.
  • Solo Claude Code y Codex son hosts estables; las demás integraciones de agentes son experimentales o heredadas.
  • El sidecar opcional de embeddings puede usar alrededor de 1-2 GB de RAM cuando está en caliente.

En colecciones

Herramientas, skills y plugins para Claude CodeFrameworks y apps de agentes de IA open sourceAsistentes y agentes de programación con IAServidores MCP

Temas

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

Preguntas frecuentes

¿Qué es haft?
Capa de gobernanza local que proporciona a los agentes de programación con IA una memoria duradera del proyecto sobre problemas, opciones comparadas, decisiones humanas, evidencias y obsolescencia. Haft es una capa de gobernanza local para agentes de programación con IA, como Claude Code y Codex. Almacena qué problema resuelve un proyecto, qué opciones se compararon, qué decisiones tomó una persona y qué evidencias las respaldan. El razonamiento pequeño y reversible puede quedarse en el chat, mientras que los resultados de los que dependerá el trabajo posterior se convierten en registros tipados del proyecto dentro de un grafo local de artefactos .haft/.
¿haft es gratuito? ¿Qué licencia tiene?
haft es open source bajo la licencia Other. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿haft sigue mantenido?
Actualizado en los últimos 6 meses. El último commit de haft fue el 28 sept 2026.
¿Para qué puedo usar haft?
Registrar por qué se tomó una decisión de arquitectura para que el trabajo posterior pueda basarse en ella Diagnosticar un fallo con varias hipótesis en paralelo y conservar el resultado para transferirlo a otras personas Comprobar si una decisión técnica anterior sigue siendo válida según las mediciones actuales Vincular los cambios en una base de código compartida asistidos por IA con una autoridad humana explícita
¿Cómo se instala haft?
Ejecuta el script oficial de instalación del README Inicializa el proyecto para tu agente (se muestra Claude Code; consulta el README para otros hosts): haft init --claude Reinicia o vuelve a conectar tu agente de programación; después, úsalo con normalidad y llama a /h-reason cuando lo necesites
¿Dónde consigo haft?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/m0n0x41d/haft

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados