guest @ hendry : ~/blog $
hoofy-tu-companion-de-desarrollo-con-ia-que-no-te-deja-cortar-camino.md
hoofy | 2026-02-25 19:22

Hoofy: Tu companion de desarrollo con IA que no te deja cortar camino

Construi un MCP server en Go que le da a tu IA memoria persistente, especificaciones estructuradas, y un pipeline adaptativo de cambios. Se llama Hoofy. Es open source. Y su unica razon de existir es que la IA construya lo que VOS queres, no lo que ella hallucina.

Hoofy - Your AI development companion


El problema que nadie quiere admitir

Todos estamos usando IA para programar. Y todos estamos sufriendo lo mismo:

  • Le pedis un feature y te da algo que se parece pero no es.
  • Abris una sesion nueva y la IA no tiene idea de lo que hiciste ayer.
  • Le decis "arreglame este bug" y te cambia la mitad del codebase.
  • Le pedis algo complejo y se inventa APIs que no existen, schemas que no matchean, y arquitectura que contradice lo que ya tenias.

El estudio de METR 2025 lo confirmo con datos: developers experimentados fueron 19% mas lentos con IA, a pesar de sentirse 20% mas rapidos. DORA 2025 encontro un 7.2% de aumento en inestabilidad por cada 25% de adopcion de IA sin estructura. McKinsey dice que solo los que usan especificaciones estructuradas ven mejoras reales (16-30%).

La IA sin estructura es un junior con confianza ciega.


Que es Hoofy

Hoofy es un MCP server -- un binario unico, escrito en Go, cero dependencias externas, con SQLite embebido. Lo conectas a cualquier herramienta de IA que soporte MCP (Claude Code, Cursor, VS Code Copilot, OpenCode, Gemini CLI) y le da a tu IA tres superpoderes:

1. Memoria Persistente (17 tools)

Tu IA finalmente recuerda. Decisiones de arquitectura, bugs que fixeaste, patrones que estableciste, descubrimientos tecnicos -- todo queda guardado en SQLite con busqueda full-text (FTS5) y un knowledge graph con relaciones tipadas.

No son notas planas. Podes conectar observaciones:

Decision: "Migramos a JWT"  ->(caused_by)->  Discovery: "Sessions no escalan"
    ^(implements)                              ^(relates_to)
Bugfix: "Fixed token expiry"             Pattern: "Retry con backoff"

Cuando la IA arranca una sesion nueva, carga este contexto automaticamente. Ya sabe donde estaba.

2. Pipeline de Cambios Adaptativo (6 tools)

Aca esta la magia para el dia a dia. Cuando necesitas hacer un cambio, Hoofy selecciona automaticamente los pasos correctos basandose en tipo x tamano:

Tipo Small Medium Large
Fix 4 stages 5 stages 6 stages
Feature 4 stages 5 stages 7 stages
Refactor 4 stages 5 stages 5 stages
Enhancement 4 stages 5 stages 7 stages

12 flows, todos deterministicos. Un bugfix chico no necesita la misma ceremonia que un sistema de autenticacion nuevo. Pero TODOS empiezan con un context-check -- Hoofy escanea tus specs existentes, cambios completados, memoria, y archivos de convenciones para detectar conflictos ANTES de escribir una sola linea.

3. Pipeline de Proyecto Greenfield (9 tools)

Para cuando arrancas algo de cero. La pipeline completa:

Init -> Propose -> Requirements -> Business Rules -> Clarity Gate -> Design -> Tasks -> Validate

La Clarity Gate es la innovacion central. Analiza tus requerimientos en 8 dimensiones (usuarios, funcionalidad, modelo de datos, integraciones, edge cases, seguridad, escala, alcance) y bloquea el avance hasta que las ambiguedades se resuelvan.

El stage de Business Rules extrae reglas declarativas usando taxonomia BRG (Definitions, Facts, Constraints, Derivations) y DDD Ubiquitous Language -- antes de que la Clarity Gate las evalue. Las reglas informan al gate, no al reves.

Validate al final cruza todos los artefactos: cada requerimiento tiene al menos un task, cada componente del diseno tiene tasks asignados, nada se sale del scope del proposal.


Que NO es Hoofy

  • No genera codigo. Hoofy genera especificaciones. La IA genera codigo DESPUES, usando esas specs como guia.
  • No reemplaza al developer. Vos seguis tomando las decisiones. Hoofy fuerza a la IA a PREGUNTARTE antes de asumir.
  • No es exclusivo de una herramienta. Es MCP standard -- funciona en cualquier IDE/tool que lo soporte.

La investigacion detras

Hoofy no esta construido sobre opiniones:

  • IEEE 29148 y IREB: Standards de ingenieria de requerimientos para elicitacion estructurada y deteccion de ambiguedades.
  • Business Rules Group (BRG): El Business Rules Manifesto establece que las reglas son ciudadanos de primera clase, no enterradas en codigo.
  • EARS (Easy Approach to Requirements Syntax): Templates respaldados por investigacion que eliminan ambiguedad en requerimientos naturales.
  • DDD Ubiquitous Language: El principio de Eric Evans de que un lenguaje compartido elimina errores de traduccion.

Un error en requerimientos cuesta 10-100x mas fixearlo en produccion que durante la especificacion (IEEE). Con codigo generado por IA, ese multiplicador es peor.


Quick Start

Instalacion:

# macOS (Homebrew)
brew install HendryAvila/hoofy/hoofy

# macOS/Linux (script)
curl -sSL https://raw.githubusercontent.com/HendryAvila/Hoofy/main/install.sh | bash

# Go
go install github.com/HendryAvila/Hoofy/cmd/hoofy@latest

Conectarlo (ejemplo Claude Code):

claude mcp add --scope user hoofy hoofy serve

Y listo. Solo habla con tu IA. Las instrucciones built-in de Hoofy le dicen cuando y como usar cada sistema.


Numeros

  • 32 tools MCP
  • 12 flow variants en el pipeline de cambios
  • 8 dimensiones de claridad
  • 6 tipos de relaciones en el knowledge graph
  • Un binario. Cero dependencias externas. MIT license.

GitHub: github.com/HendryAvila/Hoofy

Stop prompting. Start specifying.

NORMAL
-- lines hoofy 2026-02-25
Vim commands:
  • :q quit (back to posts)
  • :e edit (admin only)

0 comentarios

¡Sé el primero en comentar!

Comparte tu opinión sobre este post

Añadir comentario

Tu email no será publicado ni compartido.