decisionnode/DecisionNode

Registre una decisión, incrustela como vector y búsquela más tarde. Un almacén compartido en todas sus herramientas de IA: Claude Code, Cursor, Windsurf y cualquier cliente MCP.

No es un archivo markdown: son decisiones estructuradas con búsqueda semántica, expuestas a través de MCP.

Instalación

npm install -g decisionnode
cd your-project
decide init      # creates project store
decide setup     # configure Gemini API key (free tier)

# Connect to Claude Code (run once)
claude mcp add decisionnode -s user decide-mcp

Cómo funciona

1. Se toma una decisión: a través de decide add o la IA llama a add_decision mediante MCP.

2. Incrustada como vector: usando gemini-embedding-001 de Gemini, almacenada localmente en vectors.json.

3. La IA la recupera más tarde: llama a search_decisions mediante MCP y obtiene las decisiones relevantes clasificadas por similitud de coseno.

La recuperación es explícita: la IA llama a la herramienta MCP para buscar. Las decisiones no se inyectan en un prompt del sistema.

Dos interfaces

Ambas leen y escriben en el mismo almacén local (~/.decisionnode/).

Referencia rápida

decide add                          # interactive add
decide add -s UI -d "Use Tailwind"  # one-command add
decide add --global                 # applies to all projects
decide search "error handling"      # semantic search
decide list                         # list all (includes global)
decide deprecate ui-003             # soft-delete (reversible)
decide activate ui-003              # bring it back
decide check                        # embedding health
decide embed                        # fix missing embeddings
decide export json > decisions.json # export to file

Características

Documentación

Documentación completa en decisionnode.dev/docs

• Inicio rápido

• Referencia de CLI: todos los comandos

• Servidor MCP: 9 herramientas, configuración para Claude/Cursor/Windsurf

• Nodos de decisión: estructura, campos, ciclo de vida

• Motor de contexto: incrustación, búsqueda, detección de conflictos

• Configuración: almacenamiento, comportamiento del agente, umbral de búsqueda, decisiones globales

• Flujos de trabajo: patrones comunes

Para consumo de LLM: decisionnode.dev/decisionnode-docs.md

Contribución

Consulte ROADMAP.md para ver lo que viene a continuación. Las correcciones de errores, características, mejoras de documentación o simplemente ideas son bienvenidas. Consulte CONTRIBUTING.md para saber cómo empezar.

Licencia

MIT: consulte LICENSE.