VibeFrame

Управляющая плоскость для агентного кодинга. VibeFrame поддерживает в репозитории живую модель того, чем должно быть ваше ПО — бизнес-намерения, системный дизайн и сам код — детерминированно синхронизирует её с реальностью и показывает, где они расходятся.

Агенты пишут код быстрее, чем кто-либо может его прочитать. Испаряется теория: что существует, почему существует, какие решения являются ключевыми и соответствует ли код тому, что было решено. VibeFrame захватывает эту теорию в момент, когда это дешевле всего (на этапе планирования, через собственный MCP-протокол агента), хранит её как обычные файлы в вашем репозитории, механически проверяет её вечно и отдаёт агенту контекстные брифы под задачу, которые эффективнее повторного грепа по кодовой базе.

• Три плоскости, один граф — возможности и workflow (намерения), компоненты и ограничения (система), файлы и символы (код, на 100% производный — никогда не угаданный).

• Уровни доверия для каждого факта — A производный / B обогащённый / C утверждённый; устаревание видно, оно никогда не молчит.

• Детекция дрейфа с доказательствами — живая рефлексионная модель: расхождения, отсутствие, сломанные привязки, осиротевшие сущности, циклы, изменения зафиксированных решений. Ноль вызовов LLM; фреймворк детерминирован, а кодинг-агент — интеллект.

• Модель в репозитории — .vibeframe/ YAML/Markdown, версионируется git: безопасно для ветвления, просматриваемо в PR, переживает любой инструмент. Находящийся в gitignore SQLite-индекс является производным и пересобираемым.

• Один демон на проект — Streamable-HTTP MCP endpoint, REST + SSE и живой браузерный UI (Map, Focus, Inspector, Activity, Drift inbox, Decisions) в одном процессе.

• В первую очередь — Claude Code — плагин объединяет MCP-сервер, детерминированные хуки и навыки; модель также обслуживает любого агента через дайджест AGENTS.md.

Установка (v0.1.0 — пока не в npm)

Установите релизные тарболы напрямую из GitHub в свой проект (Node ≥ 22.12):

npm i -D https://github.com/jubayertalha/vibeframe/releases/download/v0.1.0/vibeframe-0.1.0.tgz https://github.com/jubayertalha/vibeframe/releases/download/v0.1.0/vibeframe-core-0.1.0.tgz https://github.com/jubayertalha/vibeframe/releases/download/v0.1.0/vibeframe-store-0.1.0.tgz https://github.com/jubayertalha/vibeframe/releases/download/v0.1.0/vibeframe-indexer-0.1.0.tgz https://github.com/jubayertalha/vibeframe/releases/download/v0.1.0/vibeframe-engine-0.1.0.tgz https://github.com/jubayertalha/vibeframe/releases/download/v0.1.0/vibeframe-daemon-0.1.0.tgz

(Или из клона: npm ci && npm run build && npm pack --workspaces, затем npm i -D тарболы. Не выполняйте npm i vibeframe — сейчас это имя принадлежит постороннему пакету в реестре.)

Related MCP server: Paparats MCP

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

npx vibeframe init                              # scaffold .vibeframe/ — commit it
claude mcp add vibeframe -- npx vibeframe mcp   # or install the Claude Code plugin (below)
npx vibeframe start                             # daemon + browser UI (prints the URL)

Для полного опыта Claude Code (MCP плюс детерминированные хуки и команды /vibeframe:*) установите плагин из этого репозитория внутри Claude Code: /plugin marketplace add jubayertalha/vibeframe, затем /plugin install vibeframe — и пропустите строку claude mcp add выше (плагин включает сервер).

Затем попросите агента спланировать фичу. Он ориентируется одним вызовом vibe_context, объявляет workflow до написания кода, а реализации привязывает после; всё, что он забудет, ловит детерминированный слой: нарушения возвращаются предупреждениями в том же ходе, необъяснённые изменения встают в очередь на сверку, а дрейф-инбокс показывает, где именно реальность разошлась с планом, с доказательствами вида file:line. Полное пошаговое руководство: docs/getting-started.md.

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

Статус

v0.1.0 — полный цикл на greenfield-проектах на TypeScript/JavaScript/Python: init → declare → index → link → validate → reconcile, вместе с демоном, MCP-инструментами, хуками и UI из шести линз. Осознанно отложено (см. Discovery): адаптеры для других агентов, режим внедрения в brownfield-проекты, графы вызовов на уровне символов, команды и любые hosted-решения.

Разработка

npm ci && npm run build && npm run check   # lint + typecheck + unit tests
npm run test:dogfood                       # the full-loop acceptance suite

См. docs/contributing/development.md и CLAUDE.md.

Лицензия

MIT