VibeFrame

Un plano de control para la codificación con agentes. VibeFrame mantiene un modelo vivo y dentro del repositorio de lo que tu software debería ser — la intención de negocio, el diseño del sistema y el propio código —, lo mantiene sincronizado de forma determinista con la realidad y te muestra dónde divergen.

Los agentes de codificación escriben código más deprisa de lo que cualquiera puede leerlo. Lo que se evapora es la teoría: qué existe, por qué existe, qué decisiones son estructurales y si el código sigue coincidiendo con lo que se decidió. VibeFrame captura esa teoría en el momento en que es más barato capturarla (en la planificación, mediante el protocolo MCP del propio agente), la guarda como archivos planos en tu repositorio, la verifica mecánicamente para siempre y recompensa al agente con informes de contexto acotados a la tarea que superan a tener que volver a hacer grep por el código.

• Tres planos, un único grafo: capacidades y flujos de trabajo (intención), componentes y restricciones (sistema), archivos y símbolos (código, 100% derivado — nunca adivinado).

• Niveles de confianza en cada hecho: A derivado / B realzado / C afirmado; lo desactualizado es visible, nunca silencioso.

• Detección de deriva con evidencias: un modelo de reflexión en vivo — divergencia, ausencia, enlaces rotos, huérfanos, ciclos y cambios sobre decisiones bloqueadas. Cero llamadas a LLM; la pluma es determinista y la inteligencia la pone el agente de codificación.

• Modelo dentro del repositorio: YAML/Markdown en .vibeframe/ con versionado de git: seguro entre ramas, revisable en PRs y sobrevive a cualquier herramienta. Un índice SQLite en el archivo .git se genera y se puede reconstruir.

• Un guardián por proyecto: endpoint MCP Streamable-HTTP, REST + SSE y una interfaz en navegador en directo (Map, Focus, Inspector, Activity, Drift inbox, Decisions) en un solo proceso.

• Claude Code antes que nadie: una extensión que aglomera el servidor MCP, los hooks deterministas y las skills; el modelo también sirve a cualquier agente mediante un resumen de AGENTS.md.

Instalar (v0.1.0 — aún no en npm)

Instala los tarballs de la versión directamente desde GitHub en tu proyecto (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

(O desde un clon: npm ci && npm run build && npm pack --workspaces, y luego npm i -D los tarballs. No hagas npm i vibeframe: ese nombre pertenece actualmente a un paquete no relacionado en el registro.)

Related MCP server: Paparats MCP

Inicio rápido

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)

Para la experiencia completa en Claude Code (MCP más hooks deterministas y los comandos /vibeframe:*), instala el plugin desde este repositorio dentro de Claude Code —/plugin marketplace add jubayertalha/vibeframe y después /plugin install vibeframe— y omite la línea claude mcp add de arriba (el plugin incluye el servidor).

A continuación, pide a tu agente que planifique una funcionalidad. Empieza por una única llamada a vibe_context, declara el flujo de trabajo antes de codificar y enlaza las implementaciones después. Todo lo que olvida, la capa determinista lo detecta: las violaciones vuelven como avisos en el mismo turno, los cambios sin explicar entran en la cola de reconciliación y la bandeja de la deriva muestra exactamente dónde la realidad dejó el plan, con la evidencia de línea y archivo. Recorrido completo: docs/getting-started.md.

Documentación

Estado

v0.1.0: el bucle completo en proyectos greenfield de TypeScript/JavaScript/Python: iniciar → declarar → indexar → enlazar → validar → conciliar, con el demonio, herramientas MCP, hooks y la interfaz de seis vistas. Diferido por diseño (consulta "Discovery" en la documentación): adaptadores para otros agentes, modo de adopción brownfield, grafos de funciones a nivel de símbolo, equipos y cualquier hospedaje.

Desarrollo

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

Consulta docs/contributing/development.md y CLAUDE.md.

Licencia

MIT