decisionnode/DecisionNode

Это не просто Markdown-файл — это структурированные решения с семантическим поиском, доступные через MCP.

Установка

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

Related MCP server: cogmemai-mcp

Как выглядит решение

{
  "id": "backend-007",
  "scope": "Backend",
  "decision": "Skipped connection pooling for the embeddings DB — single writer, revisit if we add a sync daemon",
  "status": "active",
  "rationale": "Only one process writes at a time in the current architecture. Pooling added complexity with no measurable benefit. If we add a background sync process this will need to change.",
  "constraints": [
    "Do not add concurrent writers without revisiting this first"
  ],
  "createdAt": "2024-11-14T09:22:00Z"
}

Хранится в формате JSON, встраивается как вектор, доступно для поиска по смыслу. Решения — это не совсем «Правила», которые ИИ должен постоянно держать в контекстном окне (для этого лучше подходят CLAUDE.md или memory.md). Решения скорее похожи на «Воспоминания», которые ИИ может извлечь, когда это действительно актуально, с помощью семантического поиска.

Как это работает

1. Принимается решение — через decide add или когда ИИ вызывает add_decision через MCP.

2. Встраивается как вектор — с использованием gemini-embedding-001 от Gemini, сохраняется локально в vectors.json.

3. ИИ извлекает его позже — вызывает search_decisions через MCP и получает релевантные решения, ранжированные по косинусному сходству.

Извлечение происходит явно — ИИ вызывает инструмент поиска решений через MCP, передавая запрос и получая топ-N решений, ранжированных по косинусному сходству. Ничего не внедряется в системный промпт заранее.

Два интерфейса

Оба интерфейса читают и записывают данные в одно и то же локальное хранилище (~/.decisionnode/).

Краткий справочник

decide add                          # interactive add
decide add -s Backend -d "Skipped connection pooling for the embeddings DB — single writer, revisit if we add a sync daemon"
decide add --global                 # applies to all projects
decide search "connection pooling"  # 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
decide ui                           # launch local web UI (graph + vector space + list)
decide ui -d                        # run UI in background, return the terminal
decide ui stop                      # stop the background UI

Возможности

decide ui — визуальный интерфейс

Локальный веб-интерфейс, который дает три живых взгляда на ваши решения:

• Граф — представление с силовым упорядочиванием, где узлы — это решения, а ребра — косинусное сходство. Наведите курсор, чтобы выделить окружение решения, перетащите ползунок порога, чтобы усилить или ослабить связи.

• Векторное пространство — UMAP-проекция 3072-мерных эмбеддингов Gemini в 2D, отображаемая в виде векторов, исходящих из начала координат. Позволяет буквально увидеть формирование семантических кластеров.

• Список — карточки с возможностью поиска, фильтрации и сортировки, сгруппированные по области действия. Скучный, но необходимый вид для чтения того, что вы сохранили.

Живой пульс MCP: когда Claude Code, Cursor, Windsurf или любой MCP-клиент ищет ваши решения, соответствующие узлы пульсируют в реальном времени цветом инструмента поиска. Вы буквально наблюдаете за тем, как думает ИИ.

decide ui            # foreground (Ctrl+C to stop)
decide ui -d         # background (terminal returns immediately)
decide ui status     # check whether the background server is running
decide ui stop       # stop the background server

Локальный HTTP-сервер на localhost:7788 (с переходом на случайный порт). Только чтение — CLI и MCP остаются путями для записи.

Другие возможности

Документация

Полная документация на decisionnode.dev/docs

• Быстрый старт

• Справочник CLI — все команды

• MCP-сервер — 9 инструментов, настройка для Claude/Cursor/Windsurf

• Узлы решений — структура, поля, жизненный цикл

• Контекстный движок — эмбеддинги, поиск, обнаружение конфликтов

• Конфигурация — хранилище, поведение агента, порог поиска, глобальные решения

• Рабочие процессы — общие паттерны

Для LLM: decisionnode.dev/decisionnode-docs.md

Участие в разработке

Смотрите ROADMAP.md, чтобы узнать, что планируется дальше. Исправления ошибок, новые функции, улучшения документации или просто идеи приветствуются. См. CONTRIBUTING.md, чтобы узнать, как начать.

Лицензия

MIT — см. LICENSE.