Accordo

Describe tu proceso de ventas a tu agente de codificación; sé dueño del CRM que construye.

Un framework de código abierto que Claude Code, Codex y Gemini CLI usan para generar una aplicación de CRM como código que tú posees: flujos de trabajo deterministas, aprobaciones humanas sujetas a políticas, auditoría y trazabilidad integradas.

El nombre está elegido y el dominio registrado. npm create accordo crea un proyecto funcional a partir del publicado create-accordo@0.1.0; el paquete accordo en sí mismo sigue siendo una reserva de nombre vacía 0.0.1 — nada instala el framework como biblioteca — y el ámbito @accordo está reclamado y deliberadamente vacío. No se ha realizado ningún examen de marcas registradas, y el proyecto no se puede desplegar en producción. Lo que eso significa exactamente está en Dónde se detiene, que merece la pena leer antes del resto.

Business request
      ↓  "Renewals of €50,000 or more need a manager's sign-off."
Claude Code / Codex
      ↓  reads AGENTS.md · 12 skills · MCP · `crm app inspect`
Modules + deterministic workflows + versioned policy
      ↓
API + Admin + trace + audit — in your repository, as code you review

Cuándo recurrir a Accordo

• CRM personalizado: cuando el proceso comercial es el producto y el resultado debe ser código revisable en lugar de configuración dentro del runtime de otra persona.

• Customer Hub: cuando «hub» significa una única cadena local de registros comerciales con acciones gobernadas. Accordo no ingiere fuentes ni resuelve identidades de clientes como un CDP.

• Smart CRM: cuando un agente de codificación debe componer la aplicación mientras una política versionada y humanos designados conservan las decisiones de negocio. Es software construido por agentes, no un tomador de decisiones autónomo.

• CDP + CRM: cuando un CDP externo gestiona la ingesta, la resolución de identidades y las audiencias, y Accordo posee la capa de proceso CRM determinista a su lado. Accordo no incluye ningún CDP, conector, importador ni runtime de sincronización.

Esos términos adyacentes son rutas de recuperación, no afirmaciones de capacidad adicionales. El mapa de recomendaciones verificado vincula cada uno a lo que el framework demuestra y dónde se detiene.

Related MCP server: Pathmode

Por qué existe esto

Todo CRM acaba pidiéndote que adaptes tu proceso a su modelo. Las dos escapatorias habituales tienen un coste:

• Configurar una plataforma — rápido de empezar, y tu personalización vive como metadatos dentro del runtime de otra persona. Cuando llega el techo, haces un fork de un monorepo.

• Construir desde cero — libertad total, y cada equipo vuelve a derivar la validación, la semántica de pipeline, las aprobaciones y la auditoría. Normalmente tarde, normalmente bajo presión.

Este framework es la tercera opción: un agente genera la aplicación, y el framework proporciona las partes que los equipos siempre hacen mal cuando se acerca una fecha límite. La prueba que cualquier desarrollador puede aplicar es «si este proyecto desaparece mañana, ¿con qué me quedo?» Aquí la respuesta es: una aplicación Node en tu repositorio, sin dependencias de runtime de terceros y un archivo SQLite que cualquier cliente puede abrir.

Lo que está demostrado

Cada línea siguiente está vinculada a una prueba fusionada. El registro completo — la afirmación, la evidencia y el límite que la acompaña — está en site/claims.json, y la disciplina de revisión que hay detrás está en docs/QUALITY_GATES.md.

Toda la suite se ejecuta en cada push, junto con la prueba de humo. Cuántas pruebas eran y el commit en el que se midieron están en site/claims.json bajo measuredAgainst — el único lugar de este repositorio en el que se anota un recuento de pruebas, y el único en el que npm run gtm:check permitirá que aparezca un número.

Ejecútalo

Node.js 22.16 o más reciente. No hay dependencias de runtime de terceros ni paso de compilación.

npm run tour     # compose the whole application and inspect it
npm run verify   # source checks, then the whole test suite
npm run falsify  # break five rules on purpose and watch the suite catch them
npm run demo     # the approval slice, end to end
npm run dev      # http://localhost:4000

npm run tour es la forma más rápida de ver qué es esto realmente. La composición predeterminada del repositorio está deliberadamente vacía — un proyecto escribe la composición que quiere —, así que crm app inspect en un clon recién hecho no informa de nada. El tour ejecuta el instalador de inicio (el mismo que CI ejecuta en cada push) en un directorio que conserva y, a continuación, inspecciona el resultado:

  modules       76        resources     71        policies       7
  packages       9        actions       64        providers      1

  production posture — local development only: no authentication, tenancy or RBAC
                       exists, and actor headers are not identity

Termina con las once cosas que el inspector dice que no puede ver, porque un recorrido que solo muestra la mitad buena no merece la pena ejecutarse. npm run tour -- --keep ./demo deja el proyecto para explorar; --json imprime un recibo legible por máquina.

npm run falsify es la otra dirección. Un recuento de pruebas dice cuánto se escribió; no dice qué tendría que salir mal para que una prueba siguiera en verde. Así que esto elimina una regla a la vez — la protección del actor humano en las aprobaciones, el límite del umbral de aprobación, la verificación de la firma del webhook, la inmutabilidad de la versión de la política, la regla de que un módulo totalmente gestionado no genera escritura pública — ejecuta la suite que debería defenderla y nombra la prueba que la detectó. Se niega a ejecutarse sobre cambios sin confirmar y restaura todos los archivos que toca. Cualquier cosa que sobreviva se imprime como una brecha, porque esa es la salida útil (docs/FALSIFY.md, tests/falsify.test.js).

npm run demo crea dos renovaciones y scripts/smoke.js lo verifica en cada push:

• 20 000 € → pasa directamente a Propuesta.

• 80 000 € → se detiene en Aprobación Pendiente hasta que un gestor decida.

Úsalo desde un agente de codificación

Claude Code lee CLAUDE.md, .mcp.json y .claude/skills/. Codex lee AGENTS.md y .codex/config.toml. Ambos están registrados en el repositorio y conectados entre sí.

Read AGENTS.md, PRODUCT.md and docs/PROJECT_STATUS.md.
Run npm run crm -- app inspect --json.
Tell me which parts of my commercial process this already supports, and which it does not.

Un arnés solo necesita: ejecutar un comando, leer stdout, leer el código de salida, analizar JSON y leer y escribir archivos. Sin servidor MCP, sin red, sin credenciales, sin base de datos, sin proceso de larga duración — docs/AGENT_HARNESS_COMPATIBILITY.md.

npm run crm -- app inspect --json          # what this application contains
npm run crm -- solution check plan.json    # is this plan still valid against it

Los códigos de salida son el contrato: 0 válido · 1 problemas, el informe aún se imprime · 2 ilegible.

El servidor MCP se ejecuta sobre stdio (node --no-warnings packages/mcp/bin/server.js) y expone inspección del proyecto, listado de oportunidades, solicitudes de cambio de etapa, decisiones de aprobación, trazas de ejecución y andamiaje de módulos. Las herramientas que generan código y las destructivas están en modo de prueba en seco a menos que pases una bandera de aplicación explícita (tests/mcp.test.js, tests/scaffold.test.js — docs/MCP.md). Es solo stdio y solo local: no hay ningún endpoint MCP alojado o autenticado, y el servidor hereda la autoridad del proceso que lo inicia.

Dónde se detiene

Lee esto antes de evaluar cualquier cosa anterior. docs/benchmarks/CRM_JTBD_MATRIX.md hace seguimiento de cada trabajo de CRM con un vocabulario de estado conservador en el que no compatible es el valor por defecto y se requiere evidencia para salir de él.

• Sin autenticación, multiinquilino ni RBAC. El servidor es solo para desarrollo local; una cabecera de actor es una afirmación, no una identidad. No lo expongas a una red.

• Solo SQLite. PostgreSQL está en la vía de la Columna Vertebral de Producción y no está implementado.

• El benchmark de compilación no se ha ejecutado. No existe una Tasa de Compilación de Agente Exitosa. Cualquier porcentaje atribuido a este proyecto es inventado — docs/strategy/CRM_BUILD_BENCHMARK.md es el protocolo, no un resultado.

• Sin programador, sin recordatorios, nada en un temporizador. Las Tareas de Seguimiento y una línea de tiempo de Actividad existen como un único modelo compartido (docs/WORK_TASKS.md) y una persona mueve cada una de ellas: una fecha de vencimiento no cambia ningún estado, no existe nada recurrente, nada se asigna o notifica, y los períodos de aviso de renovación se registran y nunca se activan.

• Sin integraciones de correo electrónico, calendario o marketing. Existe un contrato de proveedor de notificaciones; ningún adaptador envía nada a nadie.

• Sin importación, exportación, deduplicación, fusión, edición masiva, vistas guardadas ni búsqueda global. Requisitos básicos en todo CRM comercial, y ninguno de ellos tiene un hito todavía.

• Todavía no puedes poner datos reales de clientes en esto. Sin autenticación, sin multiinquilino, sin exportación y sin vía de borrado — por lo que una solicitud de acceso o eliminación de un interesado no puede atenderse con esto. docs/strategy/DATA_GOVERNANCE.md es solo diseño. Lo único que se sostiene: la puntuación de clientes potenciales es determinista, versionada y explicable, no el juicio de un modelo sobre una persona.

• Esto es un marco de trabajo, no un producto al que te suscribes. No hay CRM alojado, ni nivel gratuito, ni cuenta. La salida es una aplicación que tú ejecutas.

• La propiedad significa código fuente incorporado: no hay dependencia del marco de trabajo que actualizar. npm create accordo — el publicado create-accordo@0.1.0 — genera un proyecto que arranca, informa valid desde app inspect y sale con 0 desde project doctor, copiando el código fuente del marco de trabajo en él; el mismo arranque se ejecuta desde un checkout (node packages/create-accordo/bin/create-accordo.js <dir> --apply, sin instalación, sin red — tests/project-bootstrap.test.js). Lo que el registro te entrega es el generador, no el marco de trabajo: el paquete accordo es una reserva de nombre 0.0.1 vacía, deliberadamente. El marco de trabajo se incorpora al proyecto, por lo que eres dueño del resultado por completo — y actualizar significa fusionar, no subir una versión.

Arquitectura en cinco carpetas

packages/core/        the runtime platform: registry, services, workflow engine, audit
packages/modules/     CRM domain primitives
packages/domains/     optional domain packages (contracts, delivery) on a public contract
packages/mcp/         tools and context exposed to coding agents
apps/                 API server and generated Admin

El agente nunca escribe en una tabla de base de datos. Llama a métodos de servicio y flujos de trabajo con nombre, que preservan la validación, la identidad del actor, la política, la traza y la auditoría — ARCHITECTURE.md.

Documentos

Licencia

MIT, confirmado por ADR-023.