← Agentes

Criterio CCO

La función comercial

La evidencia antes de la decisión

Cada pronóstico que se compromete, sostenido por su evidencia

Augusto pone el embudo del CRM al lado de su evidencia y el pronóstico al lado de lo que lo sostiene. Valeria sigue cada venta hasta su contrato y su factura, y cada descuento y cada comisión contra su política. Procesan las exportaciones, no el CRM. No fijan metas, no aprueban descuentos y no califican a quien vende.

Lo que cuesta, medido por terceros

Cifras de terceros, cada una con su fuente, su año y su muestra, verificadas contra el texto de quien la publica. Las de los agentes están más abajo, en la evidencia de pruebas.

Criterio es código abierto. Si te genera valor, ayuda a financiar pruebas, documentación y las próximas capacidades.

Augusto y Valeria son la familia CCO de Criterio, una plataforma abierta de familias de agentes. Ver las familias

Industrias

Dónde está probada la familia y qué viene

El motor y los agentes están probados en las 15 entidades del material, en 5 países: 10 de industria —4 industrias— y 5 de control. El motor, además, con cada cambio del repositorio. En el mapa, cada país con su evolución.

5 países probados, en el orden en que entraron · señales y datos de la corrida más reciente de cada entidad

Ronda 1ColombiaRetail, Tecnología, Entidad de controlRonda 141 de 41 señales · 15 de 15 datos
Ronda 1MéxicoManufactura, Servicios profesionales, Entidad de controlRonda 139 de 39 señales · 15 de 15 datos
Ronda 2EcuadorRetail, Tecnología, Entidad de controlRonda 238 de 38 señales · 15 de 15 datos
Ronda 2PerúManufactura, Servicios profesionales, Entidad de controlRonda 240 de 40 señales · 15 de 15 datos
Ronda 2ChileRetail, Tecnología, Entidad de controlRonda 239 de 39 señales · 15 de 15 datos

El mapa de avance

5 países probados

Mapa de América Latina. Probados: Colombia, México, Ecuador, Perú, Chile. Siguientes: . Los demás países todavía están fuera.

Fronteras: Natural Earth, dominio público.

Chileprobado desde la ronda 2

Lo que se probó aquí

Identificación y moneda

RUT de la entidad y de cada cliente, con su forma de país · CLP

Las exportaciones del CRM se procesan desde su fuente verificada, campo por campo. Ninguna norma del país entra al cálculo: el país pone la identificación y la moneda.

Última ronda: la 2

  • Tecnología20 de 20 señales · 5 de 5 datos

    42 documentos · 5 defectos sembrados a propósito

  • Retail19 de 19 señales · 5 de 5 datos

    44 documentos · 5 defectos sembrados a propósito

  • Entidad de controlninguna señal, como debe ser · 5 de 5 datos

    28 documentos y ningún defecto: cualquier señal sería una falla

Evolución

  1. Ronda 2 · primera vez · Tecnología, Retail, Entidad de control · 39 de 39 señalessin defectos
Ver la evidencia, ronda por ronda →

Las entidades y sus defectos se escriben en el repositorio, en tests/criterio-cco/generar.py.

Criterio · Familia CCO

Dos agentes para la función comercial

Procesan las exportaciones del CRM, las cotizaciones y la liquidación de comisiones, y dicen qué pronóstico no tiene respaldo y qué venta no llegó a la factura.

CRITERIO · CCOLISTO
AUGUSTO
El pronóstico
VALERIA
De la venta a la factura
ROSTRUM
El portal
LAS FICHAS DE LA ENTIDADEl único contrato. Augusto y Valeria no se hablan entre sí: se hablan por sus fichas, y con Fidel y Clara por las de ellos.
IMPRESORA · CRITERIOHOJA 1

CRITERIO · FAMILIA CCO

Estado de la familia: sin lanzar, en su versión 0.3.0. El motor, con su prueba determinista sobre material sintético de Colombia, México, Ecuador, Perú y Chile, y las exportaciones de Salesforce, HubSpot, Dynamics 365 y Zoho; los dos agentes pasaron sus dos rondas con una clave que no ven.

De dónde viene cada nombre

Augusto
· del latín augur, el que lee las señales antes de que pasen: el pronóstico contra lo que lo sostiene
Valeria
· del latín valere, valer: lo que vale lo vendido cuando está firmado y facturado
Rostrum
· del latín rostrum, la tribuna del foro romano: sostiene lo que ya está escrito, donde otros puedan leerlo

Los dos, uno por uno

Qué hace cada uno, qué nunca hace y cómo se ve su trabajo

Cada pestaña se lee sola: alguien puede instalar un agente sin el otro. Las capturas son Rostrum, el portal de todas las familias, publicando lo que el motor calculó sobre el material de prueba de una cadena de almacenes en Colombia, antes de la ronda con los agentes.

criterio-sales

Del latín augur, el que lee las señales antes de que pasen: el pronóstico contra lo que lo sostiene.

Procesa las exportaciones del CRM, su historial de campos, la evidencia de cada oportunidad y el acta del comité comercial: el embudo contra su evidencia, el pronóstico contra lo que lo sostiene y la meta contra lo cerrado. Tú comprometes el pronóstico.

Lo que solo él hace

Revisa cada oportunidad contra el documento que exige su etapa y cuenta cuántas veces se corrió cada fecha de cierre. Suma lo cerrado y lo ponderado con evidencia, y lo pone al lado de lo que se comprometió en el comité.

Lo que responde

  • Qué oportunidad está en una etapa sin el documento que esa etapa exige
  • Qué oportunidad abierta no tiene actividad en los días configurados
  • Qué fecha de cierre se corrió más veces de las configuradas
  • Si lo comprometido supera lo que lo sostiene, más de la tolerancia
  • Si lo cerrado al corte se aparta de la meta, prorrateada por los días del periodo

Nunca

Escribe en el CRM, contacta a un cliente, fija la meta, compromete el pronóstico o califica a quien vende.

Rostrum · Entidad comercial de prueba
La cadena de almacenes en octubre con 3 señales abiertas: lo comprometido en el comité, 525 millones, contra 350 millones que lo sostienen; una oportunidad en «Compromiso» sin su orden de compra, y un cierre que se corrió tres veces.
La cadena de almacenes en octubre con 3 señales abiertas: lo comprometido en el comité, 525 millones, contra 350 millones que lo sostienen; una oportunidad en «Compromiso» sin su orden de compra, y un cierre que se corrió tres veces.Captura de Rostrum sobre el material de prueba de la cadena de almacenes, periodo de octubre de 2026. El motor corrió con la extracción correcta, tomada de la clave del material, antes de la ronda con los agentes. Es material escrito por el repositorio; no pertenece a ninguna organización.
Extiende a
Quien arma el pronóstico
Instancias
Una por entidad
Configuración
15 min · 6 preguntas
Cadencia
Con cada exportación nueva y antes del cierre del periodo; si no toca nada, se calla
Necesita de ti
Que las exportaciones del CRM y el acta del comité se guarden en su carpeta
Se configura con/criterio-sales:sales-setup

Sus comandos, por grupo

Arranque y ritmo2 comandos+
sales-setupsales-wake
El pronóstico4 comandos+
pipeline-scanpipeline-checkforecast-checktarget-check

6 comandos · 4 skills

En Rostrum

Rostrum publica lo que Augusto y Valeria ya escribieron, con la fecha en que lo escribieron. Las comisiones que revisa Valeria no salen ahí salvo que su configuración lo diga: son el pago de una persona.

Cómo entra al portal

  1. Augusto corre /criterio-sales:sales-setup, deja su configuración en .criterio/comercial/<entidad>/ y marca su carpeta raíz con _CRITERIO_COMERCIAL.txt.
  2. Valeria corre /criterio-revenue:revenue-setup, deja su configuración en .criterio/ingresos/<entidad>/ y marca su carpeta raíz con _CRITERIO_COMERCIAL.txt.

Rostrum la suma al mapa y levanta el portal; las comisiones quedan fuera salvo que la configuración de Valeria diga que se publican:

/plugin install criterio-server@criterio
/criterio-server:server-setup
/criterio-server:server-start

Lo que tiene en Rostrum

Inicio
La tarjeta Criterio CCO, con Augusto, Valeria y sus señales abiertas.
La familia
Lo último de su motor, sus señales en palabras y sus reportes tal como los dejaron.
Lo que vence
Las fechas de cierre del embudo, junto a los plazos de las otras familias.
Dónde trabaja
La ruta completa de la carpeta comercial con su marca, del estado y de la configuración.
Preguntar
Una pregunta escrita para Augusto o para Valeria, que la atiende en su siguiente corrida.
La página de Criterio CCO en Rostrum
La página de Criterio CCO en Rostrum, sobre el material de prueba de una cadena de almacenes en Colombia: lo que dejaron Augusto y Valeria en su ronda, con una clave que no ven.
Rostrum: instalación, configuración y uso con todas las familias →

Lo que te cuesta hoy

El trabajo que preparan Augusto y Valeria, costeado con tus números

Augusto extiende a quien arma el pronóstico; Valeria, a quien sigue la venta hasta la factura. Pon cuántas personas hacen cada trabajo, lo que cuestan y cuántas horas a la semana se les van en cada tarea. Nada de lo que escribas sale de tu navegador.

Trabajo en

Escribe los costos en la moneda que elijas. No hay conversión: al cambiar la moneda los costos se borran, porque una tasa de cambio escrita en una página está equivocada en dos semanas.

Las personas

Quien arma el pronóstico
Costo mensual cargado por personaCargado completo: salario, prestaciones y overhead.
USD

Horas por semana en cada tarea

Consolidar las exportaciones del CRM y ver qué cambió en el embudo/pipeline-scan
h
Revisar cada oportunidad contra el documento que exige su etapa/pipeline-check
h
Sostener el pronóstico comprometido, oportunidad por oportunidad/forecast-check
h
Comparar lo cerrado contra la meta del periodo/target-check
h

Las horas son por persona y por semana. Las personas y las horas iniciales son de ejemplo: reemplázalas por las tuyas. El costo lo escribes tú: no ponemos uno que no podamos sustentar.

Tus números · al año

Augusto

Quien arma el pronóstico · 12 h por semana cada uno (30% de la semana)

1.104 hal año

—al año

Valeria

Quien sigue la venta hasta la factura · 10 h por semana cada uno (25% de la semana)

920 hal año

—al año

Costo anual del trabajo que preparan Augusto y Valeria—
Horas al año2.024 h
Costo anual de las personas incluidas—
Proporción de ese costo—

Escribe el costo mensual de cada grupo para ver lo que cuesta.

Rostrum, el servidor, no suma horas aquí. Si la configuración lo dice, Rostrum deja sus reportes donde el comité comercial los ve; las comisiones no salen ahí salvo que la configuración lo diga. Su efecto es menos «¿de dónde sale este pronóstico?» antes del comité; eso no lo medimos todavía.

Lo que este número es y lo que no es

Es el costo de las horas que el área comercial dedica hoy a tareas que Augusto y Valeria preparan: revisar el embudo contra su evidencia, sostener el pronóstico, revisar los descuentos, perseguir el contrato y la factura de cada venta ganada, revisar las comisiones. No es un ahorro. La persona sigue revisando y decidiendo: el pronóstico, el descuento y la meta son suyos.

Cuántas de esas horas se recuperan lo vamos a publicar en la sección de evidencias, con las pruebas de cada ronda. Hasta tener esa cifra medida, no la ponemos aquí.

Evidencia de pruebas · se actualiza con cada ronda

Esto es lo que ya está medido, con qué muestra y con qué margen.

Cada cifra sale de una corrida real del repositorio, con su conteo y su margen de confianza del 95 %. El motor se prueba con cada cambio del repositorio; los agentes, en rondas sobre el material de una entidad.

Cómo se prueba

4 industrias y 5 controles

El motor, en todas. Los agentes, hasta hoy en las 15 entidades del material, en 5 países. En las entidades de control no hay ningún defecto: cualquier señal es una falla.

4 comandos por entidad

Augusto y Valeria corren el setup y el procesamiento de cada agente —los comandos que procesan los documentos y escriben las fichas—, con un tope de tokens fijado antes de empezar. Los demás calculan sobre esas fichas con el motor, que se prueba con cada cambio del repositorio.

567 documentos

Lo que tiene el material de las entidades medidas, en texto, PDF, CSV, JSON, Excel y Word. La clave no se cuenta: los agentes no la tienen.

61,3 millones de tokens

El trabajo del modelo de lenguaje (LLM) en la corrida más reciente de cada entidad —rondas 1 y 2—, con sus verificaciones. Ningún comando se repitió.

Una clave que no ven

Lo esperado se escribe en la clave de cada entidad antes de correr: cada señal sembrada y cada dato que traen los documentos escritos.

Margen del 95 %

Cada cifra va con su margen de confianza: dice cuánto sostiene la muestra, que un porcentaje solo no dice.

Augusto y Valeria procesan la documentación de la entidad

Rondas 1 y 2 · 15 entidades · la corrida más reciente de cada una

Lo que escribieron se califica contra la clave que no vieron: cada señal por su nombre y su clave, y cada dato de las fichas contra lo que traen los documentos escritos. Cuenta la corrida más reciente de cada entidad, sea de la ronda que sea; si se corrigió un defecto, la que lo verificó. Las primeras corridas, con lo que fallaron, están en la gráfica y en el detalle.

Datos de las fichas

95,1 % o más

Lo medido: 100 %. El titular es el piso del margen de confianza del 95 %: lo que la prueba sostiene.

75 de 75 datos extraídos de los documentos escritos coinciden con la clave.

Medido

Verificación de CCO-2: Augusto, Valeria sobre servicios profesionales · México, 5 de 5 datos.

Verificación de : Augusto, Valeria sobre tecnología · Colombia, 5 de 5 datos.

Verificación de CCO-3: Augusto, Valeria sobre entidad de control · México, 5 de 5 datos.

Verificación de CCO-4: Augusto, Valeria sobre entidad de control · Perú, 5 de 5 datos.

Margen de confianza del 95% (Wilson): 95,1–100%

Señales encontradas

98 % o más

Lo medido: 100 %. El titular es el piso del margen de confianza del 95 %: lo que la prueba sostiene.

197 de 197 señales que la clave esperaba.

Medido

Margen de confianza del 95% (Wilson): 98–100%

Señales correctas

98 % o más

Lo medido: 100 %. El titular es el piso del margen de confianza del 95 %: lo que la prueba sostiene.

197 de 197 señales que levantaron eran correctas.

Medido

Margen de confianza del 95% (Wilson): 98–100%

Controles sin falsas alarmas

5 de 5

5 de 5 entidades de control sin una señal de más.

Medido

60 comandos corridos en 15 entidades, cada uno con su salida, su costo y su calificación publicados.

Cómo avanza la familia de una ronda a otra

Cada punto es una entidad en su primera corrida de la ronda; la línea es su margen de confianza del 95 %. Las verificaciones van aparte: repiten lo que se corrigió. El eje empieza en el valor más bajo publicado.

retail · Chileretail · Colombiaretail · Ecuadormanufactura · Méxicomanufactura · Perúservicios profesionales · Méxicoservicios profesionales · Perútecnología · Chiletecnología · Colombiatecnología · Ecuadorentidad de control · Colombiaentidad de control · Ecuadorentidad de control · Perúentidad de control · Chileentidad de control · México

Ronda 11

Ronda 1 · verificación2

Ronda 23

Ronda 2 · verificación4

  1. 1 · Ronda 1: Augusto y Valeria sobre entidad de control · Colombia, entidad de control · México, manufactura · México, retail · Colombia, servicios profesionales · México y tecnología · Colombia.
  2. 2 · Verificación en la ronda 1: Augusto, Valeria sobre entidad de control · México, después de corregir . Verificación en la ronda 1: Augusto, Valeria sobre entidad de control · México, después de corregir CCO-3. Verificación en la ronda 1: Augusto, Valeria sobre servicios profesionales · México, después de corregir CCO-2. Verificación en la ronda 1: Augusto, Valeria sobre tecnología · Colombia, después de corregir .
  3. 3 · Ronda 2: Augusto y Valeria sobre entidad de control · Chile, entidad de control · Ecuador, entidad de control · Perú, manufactura · Perú, retail · Chile, retail · Ecuador, servicios profesionales · Perú, tecnología · Chile y tecnología · Ecuador.
  4. 4 · Verificación en la ronda 2: Augusto, Valeria sobre entidad de control · Perú, después de corregir CCO-4.

Resultados por país · la corrida más reciente de cada país

Cada país con sus entidades en su corrida más reciente con el agente. El margen es el intervalo de Wilson al 95 %.

PaísEntidadesRondaDatos de las fichasSeñales encontradasSeñales correctasControles sin falsas alarmas
Colombia3115 de 15 · 100%IC 95% 79,6–100%41 de 41 · 100%IC 95% 91,4–100%41 de 41 · 100%IC 95% 91,4–100%1 de 1
Ecuador3215 de 15 · 100%IC 95% 79,6–100%38 de 38 · 100%IC 95% 90,8–100%38 de 38 · 100%IC 95% 90,8–100%1 de 1
Perú3215 de 15 · 100%IC 95% 79,6–100%40 de 40 · 100%IC 95% 91,2–100%40 de 40 · 100%IC 95% 91,2–100%1 de 1
Chile3215 de 15 · 100%IC 95% 79,6–100%39 de 39 · 100%IC 95% 91–100%39 de 39 · 100%IC 95% 91–100%1 de 1
México3115 de 15 · 100%IC 95% 79,6–100%39 de 39 · 100%IC 95% 91–100%39 de 39 · 100%IC 95% 91–100%1 de 1

Defectos encontrados por las rondas · 4

Cada error se registra con su origen y el commit que lo corrige. Se da por verificado solo cuando una corrida posterior a la corrección da lo esperado.

  • 4 Corregido y verificado
  • 0 Corregido, por verificar
  • 0 Abierto

De dónde vinieron

  • el arnés de prueba1
  • los datos de prueba1
  • el código1
  • las instrucciones del agente1

Para auditar

El detalle completo de cada corrida. Se abre cada bloque por separado.

Cada corrida de la ronda20 corridas

Augusto y Valeria corren sus comandos sobre el material de cada entidad, con un tope de tokens fijado antes de empezar. Lo que escriben se califica contra la clave que no ven: cada señal por su nombre, y cada dato de las fichas contra lo que traen las propuestas, el acta y las cotizaciones.

Material de pruebaAgente · comandosSeñalesDatos de las fichasTokens
entidad de controlRonda 1 · ColombiaAugusto, Valeria · 40 / 05 / 53,2 M
entidad de controlRonda 1 · MéxicoAugusto, Valeria · 40 / 0 · +25 / 52,9 M
entidad de controlRonda 1 · México · verificaciónAugusto, Valeria · 40 / 05 / 52,9 M
entidad de controlRonda 1 · México · verificaciónAugusto, Valeria · 40 / 05 / 52,9 M
manufacturaRonda 1 · MéxicoAugusto, Valeria · 420 / 205 / 53,1 M
retailRonda 1 · ColombiaAugusto, Valeria · 421 / 215 / 52,8 M
servicios profesionalesRonda 1 · MéxicoAugusto, Valeria · 415 / 195 / 53,2 M
servicios profesionalesRonda 1 · México · verificaciónAugusto, Valeria · 419 / 195 / 53,3 M
tecnologíaRonda 1 · ColombiaAugusto, Valeria · 416 / 205 / 53,5 M
tecnologíaRonda 1 · Colombia · verificaciónAugusto, Valeria · 420 / 205 / 53,2 M
entidad de controlRonda 2 · ChileAugusto, Valeria · 40 / 05 / 52,6 M
entidad de controlRonda 2 · EcuadorAugusto, Valeria · 40 / 05 / 53,1 M
entidad de controlRonda 2 · PerúAugusto, Valeria · 40 / 0 · +15 / 52,9 M
entidad de controlRonda 2 · Perú · verificaciónAugusto, Valeria · 40 / 05 / 52,9 M
manufacturaRonda 2 · PerúAugusto, Valeria · 420 / 205 / 53,2 M
retailRonda 2 · ChileAugusto, Valeria · 419 / 195 / 53,2 M
retailRonda 2 · EcuadorAugusto, Valeria · 418 / 185 / 53,2 M
servicios profesionalesRonda 2 · PerúAugusto, Valeria · 420 / 205 / 53,1 M
tecnologíaRonda 2 · ChileAugusto, Valeria · 420 / 205 / 53 M
tecnologíaRonda 2 · EcuadorAugusto, Valeria · 420 / 205 / 53,1 M
Los defectos, uno por uno4 defectos
  • CCO-1Corregido y verificado

    El arnés calificaba la evidencia de la ficha comercial como mal porque Augusto la escribió en otro orden: las diecinueve propuestas y órdenes de compra estaban todas, con su monto, su fecha y su cita.

    Una lista de registros de la ficha se califica sin orden: cada registro de la clave contra uno distinto de la ficha. La primera corrida de retail se volvió a calificar con la regla nueva, sin repetir comandos, y las demás entidades se calificaron con ella.

    el arnés de prueba · retail · Colombia · 13b91ad2

  • CCO-2Corregido y verificado

    En servicios de México y en tecnología de Colombia, la clave esperaba que una fecha de cierre corrida dos veces se señalara, con un umbral de una vez que ningún documento de la entidad decía. Augusto tomó el umbral de omisión, dos veces, y no levantó las cuatro oportunidades de cada entidad.

    Cada entidad trae su política comercial en 00-referencia/ con los dos umbrales que pregunta el setup. Se repitieron la instalación y el procesamiento de los dos agentes en las dos entidades: 19 de 19 y 20 de 20 señales, ninguna de más.

    los datos de prueba · servicios profesionales · México · 30197756

  • CCO-3Corregido y verificado

    En el control de México, con la exportación de HubSpot, la configuración quedó sin la columna de la empresa asociada. Sin ella Valeria no cruzó lo ganado con lo facturado, el plan dio cero y las dos liquidaciones de comisiones salieron como diferencias: dos señales de más en un control. En tecnología de Colombia, con el mismo HubSpot, sí la mapeó.

    Primero el motor reconoció la columna por el nombre «Associated Company», y la corrida control-mx-2 salió limpia; pero la fuente de HubSpot (F-05) no fija ese nombre, y se retiró. La corrección que queda está en la configuración: con HubSpot, sin la columna de la empresa asociada la configuración no pasa, y el setup tiene que decir cuál es. Se repitieron la instalación y el procesamiento de los dos agentes en el control de México: Augusto dijo cuál columna trae la empresa asociada y no hubo ninguna señal, como debe ser.

    el código · entidad de control · México · 5aefad59

  • CCO-4Corregido y verificado

    En el control de Perú, con la exportación de Zoho, Augusto no mapeó la columna «Last Activity Time». La última actividad no es un campo estándar de Zoho (F-08), así que el motor tomó lo detenido de los cortes: una oportunidad que se gestionaba y no cambió de etapa, monto ni cierre salió como detenida. Fue una señal de más en un control. En Ecuador y en Chile, con el mismo Zoho, tampoco la mapeó, pero ahí esa oportunidad era la detenida sembrada.

    Cuando una exportación trae una columna que parece la última actividad y no está mapeada, `exportacion` lo pregunta con la columna que propone. El setup hace esa pregunta y, con un sí, la registra en `crm.columns`. Se repitieron la instalación y el procesamiento de los dos agentes en el control de Perú: Augusto registró «Last Activity Time» como la última actividad y no hubo ninguna señal, como debe ser.

    las instrucciones del agente · entidad de control · Perú · ada6141f

Cómo se probó el motor15 entidades

Material sintético de manufactura (México), manufactura (Perú), retail (Chile), retail (Colombia), retail (Ecuador), servicios profesionales (México), servicios profesionales (Perú), tecnología (Chile), tecnología (Colombia), tecnología (Ecuador), más 5 entidades de control sin ningún defecto: 15 entidades con sus exportaciones del CRM, su comité, sus cotizaciones y su liquidación de comisiones, y una clave que el motor no ve.

197

señales sembradas a propósito, cada una con su clave

9 de 9

señales de la familia sembradas al menos una vez

5

entidades de control, en las que cualquier señal es una falla

El motor levanta cada señal esperada y ninguna de más, y la puerta que lo comprueba corre con cada cambio del repositorio. El material prueba además las reglas de la operación real: seis formatos de exportación —Salesforce por API y por informe, HubSpot en CSV y en Excel, y un CRM cualquiera en CSV y en Excel—, y que ninguna ficha guarde el correo o el teléfono de un cliente.

Lo que sigue

  • La ronda 3 con el agente, sobre todo el material otra vez.
  • El primer uso sobre la documentación de una organización concreta.
  • Cuántas horas recuperan los agentes no está medido todavía. Hasta medirlo, no lo publicamos.

Una página de resultados que solo dice lo que pasó es publicidad. Lo que la vuelve auditable es lo que dice que todavía no se sabe.

Hoja de ruta

La familia crece por incrementos, cada uno con su prueba completa

Cada incremento es una versión con su prueba completa y su análisis estadístico publicados, con las mismas métricas, para que la evolución se pueda comparar. Las versiones se suman: la última liberada trae todo lo anterior y las correcciones de lo que encontraron sus pruebas.

EstableLo dice su evidencia, no su número: en la corrida más reciente de cada entidad de su material, el piso del margen del 95 % es de 95 % o más en señales y en datos, y ningún control levantó una señal. Cada número entero tiene diez versiones, de x.0 a x.9; después viene la x+1.0.

  1. 0.1.0

    Liberada

    Liberada el 2026-10-28

    Augusto y Valeria, construidos, con el motor probado

    • Los comandos, sus skills y el motor, con las nueve señales: el embudo, el pronóstico y la meta de Augusto; el descuento, el contrato, la factura y la comisión de Valeria
    • Las exportaciones de Salesforce y de HubSpot, y cualquier CSV o Excel con su mapeo de columnas
    • Lo ganado contra los contratos de Fidel y lo firmado contra las facturas de Clara, por sus fichas
    • Colombia y México, con entidades de control

    Prueba

    El motor contra la clave de todo el material: seis entidades de Colombia y México, con sus controles

  2. 0.2.0

    Liberada

    Liberada el 2026-10-29

    La ronda completa con los agentes

    • Augusto y Valeria corren sus comandos sobre todas las entidades del material, con una clave que no ven
    • El material siembra al menos 73 señales: lo que pide un piso del 95 % sin fallas (decisión 0020)
    • Cada defecto que encuentre la ronda, con su corrección y su verificación

    Prueba

    La ronda 1 con los dos agentes sobre las seis entidades del material: 72 de 80 señales sembradas y 30 de 30 datos en la primera corrida, con dos señales de más en un control, y 80 de 80 sin ninguna de más después de verificar las correcciones; los tres defectos que encontró, con su corrección y su verificación

  3. Último liberado

    0.3.0

    Liberada

    Liberada el 2026-10-29

    Trae todo lo anterior y sus correcciones

    Ecuador, Perú y Chile, y Microsoft Dynamics y Zoho

    • Los tres países que ya están en el registro de países, con su material y su ronda
    • Las exportaciones de Microsoft Dynamics y de Zoho, cada una desde su fuente verificada

    Prueba

    La ronda 2 con los dos agentes sobre las nueve entidades de Ecuador, Perú y Chile, tres con Dynamics y tres con Zoho: 117 de 117 señales sembradas y 45 de 45 datos en la primera corrida, con una señal de más en un control; el defecto que encontró, en las instrucciones, con su corrección y su verificación

La misma hoja de ruta vive en el repositorio, en families/criterio-cco/hoja-de-ruta.json.

Cómo trabajan

Cinco pasos y una frontera. El modelo de lenguaje (LLM) extrae lo que solo trae un documento escrito; el código calcula todo lo demás. Es IA generativa más un motor determinista, aplicada a la función comercial.

  1. 01

    Tus exportaciones

    Las exportaciones del CRM con su fecha, su historial de campos, la evidencia de cada oportunidad, el acta del comité, las cotizaciones y la liquidación de comisiones. Como estén, donde estén.

    No se conecta al CRM.

    El modelo extrae
  2. 02

    El embudo

    El motor procesa cada exportación desde su formato —Salesforce, HubSpot o cualquier CRM en CSV o Excel— y compara un corte con el anterior. Lo que no puede procesar lo declara, con la razón.

    Una columna que no reconoce se pregunta, no se adivina.

    El modelo extrae
  3. 03

    La ficha

    Una por entidad y periodo para cada agente: la evidencia de cada oportunidad, el pronóstico comprometido del acta y cada cotización con su descuento y su aprobación, cada dato con su cita.

    «No encontrado» es una respuesta válida.

    El modelo extrae
  4. 04

    El motor

    Cada etapa contra su evidencia, los días sin actividad, los cierres que se corren, lo comprometido contra lo ponderado con evidencia, la meta prorrateada, cada descuento contra su nivel, lo ganado contra su contrato y su factura, y la comisión contra el plan.

    Determinista y probado.

    El código calcula
  5. 05

    Señales

    Solo lo que cruzó un umbral: lo que no tiene evidencia, lo que se detuvo, lo que se corrió y lo que no llegó a la factura. Si nada lo cruzó, no dice nada.

    El silencio es la característica.

    El código calcula

Ningún monto, porcentaje, día o conteo de un reporte sale de una estimación. Y lo que no está dicho en ninguna parte se declara, no se completa.

Por qué importa esta frontera →

Siete invariantes que los sostienen

01

Los agentes no se hablan entre sí

Se hablan por sus fichas, y con Fidel y Clara por las de ellos. Valeria no vuelve a procesar un contrato ni una factura.

02

Rostrum no escribe

Sirve lo que el motor ya escribió, con su fecha, y no recalcula nada. Las comisiones no salen ahí salvo que la configuración lo diga.

03

Exportaciones, nunca sistemas

Ningún agente se conecta al CRM, y ninguno escribe en él.

04

Comprometido y respaldado nunca se fusionan

Lo que el comité compromete va en la ficha; lo que lo sostiene lo calcula el motor, y la diferencia es la señal.

05

El modelo extrae, el código calcula

Todo monto, porcentaje, día o conteo de un reporte sale del motor. Si el motor no lo da, no se escribe.

06

Ningún agente decide

El pronóstico, el descuento, la meta y la comisión son de una persona.

07

No califica personas, y no guarda datos de contacto

La señal es de la oportunidad, no de quien la lleva, y la ficha guarda la cuenta, no el correo ni el teléfono de nadie.

El detalle

Para quien quiere revisarlo todo

Los comandos con su entrada, su proceso y su reporte; las señales que calcula el código; la estructura de carpetas; las fuentes, y los enlaces al repositorio.

Los comandos de Augusto7 comandos

En orden de importancia. El primero deja la configuración que los demás necesitan.

  1. 0sales-setup

    La configuración, el inventario y el formato de cada exportación del CRM

    Entrada
    La carpeta raíz. Preguntas: entidad y su identificación fiscal, país, el periodo, de qué CRM sale la exportación de 10-crm/ —Salesforce, HubSpot, Dynamics 365, Zoho u otro, en CSV o Excel— y, si es otro, qué columna trae cada dato, la tabla de etapas de 00-referencia/ con el documento que exige cada una y su probabilidad, cuántos días sin actividad detienen una oportunidad y cuántas veces puede correrse un cierre
    Proceso (lo calcula el código)
    Inventario de lo que hay; reconoce el formato de cada exportación por sus columnas (F-02, F-04); compara la carpeta con la estructura recomendada; no crea, mueve ni renombra nada
    Reporte
    Configuración guardada; inventario por carpeta; cada exportación con su formato, su fecha y sus oportunidades; las columnas que faltan; la primera ficha del periodo
  2. 1pipeline-scan

    La ficha del periodo al día, con lo que cambió en el embudo y las señales nuevas

    Entrada
    10-crm/ completo, 20-comite/ y 30-evidencia/
    Proceso (lo calcula el código)
    El código procesa cada exportación con su fecha y compara cada oportunidad con la exportación anterior: etapa, monto y fecha de cierre; el agente lleva a la ficha del periodo cada documento de 30-evidencia/ —la propuesta, la orden de compra, el acta de aceptación— con su oportunidad, su tipo, su monto y su fecha, y el pronóstico comprometido del acta del comité, cada dato con su cita; el motor valida la ficha
    Reporte
    Qué cambió entre la exportación anterior y la última; las oportunidades nuevas, ganadas y perdidas; las señales nuevas; lo que no se pudo procesar y por qué
  3. 2pipeline-check

    Cada oportunidad contra su evidencia: la que no la tiene, la detenida y la que corre su cierre

    Entrada
    La última exportación de 10-crm/, las anteriores, la tabla de etapas de 00-referencia/ y la ficha del periodo
    Proceso (lo calcula el código)
    Cada oportunidad abierta contra el documento que exige su etapa; los días desde su última actividad; las veces que su fecha de cierre se corrió entre una exportación y otra, o en el historial de campos si llega
    Reporte
    Las oportunidades sin el documento de su etapa, las detenidas y las que corrieron su cierre, cada una con su cita; sin calificar a quien la lleva
  4. 3forecast-check

    El pronóstico comprometido contra lo que lo sostiene, oportunidad por oportunidad

    Entrada
    El pronóstico comprometido de la ficha, la última exportación de 10-crm/ y la tabla de etapas de 00-referencia/
    Proceso (lo calcula el código)
    Lo cerrado del periodo más las oportunidades abiertas que cierran en él con la evidencia de su etapa, cada una por su monto y la probabilidad de su etapa, contra lo comprometido; la diferencia contra la tolerancia configurada
    Reporte
    Lo comprometido, lo cerrado, lo ponderado con evidencia y lo ponderado sin ella; la diferencia; las oportunidades que lo sostienen y las que no
  5. 4target-check

    La meta del periodo contra lo cerrado al corte, por línea

    Entrada
    Las metas de 00-referencia/ y la última exportación de 10-crm/
    Proceso (lo calcula el código)
    Lo ganado con cierre en el periodo hasta la fecha de corte contra la meta del periodo prorrateada por los días transcurridos, por línea si la meta la trae; la diferencia contra el umbral configurado
    Reporte
    La meta, lo esperado al corte, lo cerrado y la diferencia por línea; nunca por persona
  6. 5sales-wake

    Lo que toca hoy en el embudo; si no toca nada, se calla

    Entrada
    La configuración y la ficha
    Proceso (lo calcula el código)
    Decide qué toca: una exportación nueva en 10-crm/, un acta nueva del comité, el cierre del periodo que se acerca y una revisión semanal
    Reporte
    Lo que corrió y lo que encontró; si no toca nada, se calla
  7. 6share-findings

    Un resumen sin datos para compartir, solo si dices que sí

    Entrada
    El rastro local de las corridas de este agente, en .criterio/corridas/
    Proceso (lo calcula el código)
    El código arma un resumen sin datos —el plugin y su versión, cada comando con cuántas veces corrió y su duración mediana, cada señal por su código con cuántas veces salió— y pregunta siempre si se quiere compartir; nada se envía (decisión 0025)
    Reporte
    El resumen tal cual y, con un sí, el enlace a la plantilla de hallazgo del repositorio, que abre la persona
Los comandos de Valeria7 comandos

En orden de importancia. El primero deja la configuración que los demás necesitan.

  1. 0revenue-setup

    La configuración, el inventario y las cuentas que faltan para cruzar con Fidel y Clara

    Entrada
    La carpeta raíz. Preguntas: entidad y su identificación fiscal, país, el periodo, la matriz de descuentos, el plan de comisiones y la tabla de cuentas de 00-referencia/, dónde están las fichas de los contratos de Fidel y las de la facturación de Clara, y en cuántos días se factura un contrato firmado
    Proceso (lo calcula el código)
    Inventario de lo que hay; compara la carpeta con la estructura recomendada; comprueba que cada cuenta ganada tenga su identificación en la tabla de cuentas; no crea, mueve ni renombra nada
    Reporte
    Configuración guardada; inventario por carpeta; las cuentas sin identificación; si encontró las fichas de Fidel y de Clara; la primera ficha del periodo
  2. 1deal-scan

    La ficha del periodo al día, con las cotizaciones nuevas y las señales nuevas

    Entrada
    40-cotizaciones/ completo y la última exportación de 10-crm/
    Proceso (lo calcula el código)
    Reprocesa solo lo que cambió; el agente lleva a la ficha del periodo cada cotización o pedido con su oportunidad, su precio de lista, su descuento y quién lo aprobó con qué cargo y en qué fecha, cada dato con su cita; el motor valida la ficha
    Reporte
    Qué cambió; qué cotizaciones son nuevas; las señales nuevas; lo que no se pudo procesar y por qué
  3. 2discount-check

    Cada descuento contra su política y su aprobación

    Entrada
    La matriz de descuentos de 00-referencia/ y la ficha del periodo
    Proceso (lo calcula el código)
    Cada descuento contra el nivel de la matriz que lo cubre y la aprobación que ese nivel pide; un descuento que ningún nivel cubre siempre se señala
    Reporte
    Cada cotización con su descuento, su nivel, la aprobación que pide y la que tiene; las que quedan fuera de la política, con su cita
  4. 3won-to-invoice

    De lo ganado a lo firmado y a lo facturado: lo que se quedó en el camino

    Entrada
    La última exportación de 10-crm/, la tabla de cuentas de 00-referencia/, las fichas de los contratos de Fidel y las de la facturación de Clara
    Proceso (lo calcula el código)
    Cada oportunidad ganada contra un contrato firmado con su cliente en las fichas de Fidel; cada contrato firmado con un cliente contra una factura emitida a ese cliente en las fichas de Clara, dentro del plazo de facturación
    Reporte
    Lo ganado sin contrato y lo firmado sin factura, cada uno con su cita en el CRM y en la ficha del otro agente; los contratos no se vuelven a procesar
  5. 4commission-check

    Cada comisión liquidada contra la que da el plan

    Entrada
    El plan de comisiones de 00-referencia/, la liquidación del periodo de 50-comisiones/, la última exportación de 10-crm/ y las fichas de la facturación de Clara
    Proceso (lo calcula el código)
    Lo que el plan da sobre lo ganado en el periodo y ya facturado, por responsable de la oportunidad y por línea, contra lo que se liquidó; la diferencia contra la tolerancia configurada
    Reporte
    Por responsable: lo que da el plan, lo liquidado y la diferencia, con las oportunidades que forman la base; no se publica en Rostrum salvo que la configuración lo diga
  6. 5revenue-wake

    Lo que toca hoy de la venta a la factura; si no toca nada, se calla

    Entrada
    La configuración y la ficha
    Proceso (lo calcula el código)
    Decide qué toca: cotizaciones nuevas, una oportunidad ganada sin contrato ni factura cuando vence su plazo, la liquidación del periodo cuando llega y una revisión semanal
    Reporte
    Lo que corrió y lo que encontró; si no toca nada, se calla
  7. 6share-findings

    Un resumen sin datos para compartir, solo si dices que sí

    Entrada
    El rastro local de las corridas de este agente, en .criterio/corridas/
    Proceso (lo calcula el código)
    El código arma un resumen sin datos —el plugin y su versión, cada comando con cuántas veces corrió y su duración mediana, cada señal por su código con cuántas veces salió— y pregunta siempre si se quiere compartir; nada se envía (decisión 0025)
    Reporte
    El resumen tal cual y, con un sí, el enlace a la plantilla de hallazgo del repositorio, que abre la persona
Lo que calcula el código9 señales

9 señales. Cada una se levanta con la oportunidad, la cotización o la comisión que la causa, su monto y la cita del documento; los días, las veces y las tolerancias son configuración de cada entidad.

Augusto · 5

  • stage_without_evidence

    Una oportunidad está en una etapa y no tiene el documento que esa etapa exige: la propuesta enviada, la orden de compra

  • stalled_opportunity

    Una oportunidad abierta no tiene actividad registrada en los días configurados

  • close_date_slipped

    La fecha de cierre de una oportunidad se movió más veces de las configuradas

  • forecast_unsupported

    Lo comprometido supera lo que suman las oportunidades con evidencia, ponderadas por su etapa, más de la tolerancia configurada

  • target_vs_closed

    Lo cerrado al corte se aparta de la meta del periodo, prorrateada por los días transcurridos, más del umbral

Valeria · 4

  • discount_outside_policy

    Un descuento supera el tope de su nivel y no tiene la aprobación que pide la matriz, o ningún nivel lo cubre

  • won_without_contract

    Una oportunidad ganada no tiene su contrato firmado en la ficha de Fidel

  • signed_without_invoice

    Un contrato firmado no tiene su factura en la ficha de Clara dentro del plazo de facturación

  • commission_differs_from_plan

    La comisión liquidada no es la que da el plan sobre lo cerrado y facturado

La estructura de carpetascomercial/

Recomendada, no obligatoria: los agentes procesan la carpeta como esté. El setup dice qué archivo está fuera de su lugar y dónde iría, sin crear, mover ni renombrar nada. Busca la carpeta comercial de la entidad, la propone con la razón y, si dices que sí, la marca con un archivo visible, _CRITERIO_COMERCIAL.txt. Entre tus documentos no escriben nada más: lo que encuentran va en su estado, aparte.

Una carpeta por entidad, con el NIT o el RFC al inicio del nombre. Dentro, la referencia de la función comercial, las exportaciones del CRM con su fecha, el comité, la evidencia de cada oportunidad, las cotizaciones y las liquidaciones de comisiones.

comercial/
└── <entidad>/
    ├── 00-referencia/
    ├── 10-crm/
    ├── 20-comite/
    ├── 30-evidencia/
    ├── 40-cotizaciones/
    └── 50-comisiones/
estado-comercial/

<entidad>/ · Lo que la organización lleva para toda la función comercial

CarpetaQué vaAgente
00-referencia/La tabla de etapas —el documento que exige cada una y su probabilidad—, las metas del año, la matriz de descuentos, el plan de comisiones y la tabla de cuentas con la identificación de cada clienteAugusto, Valeria
10-crm/Las exportaciones de oportunidades del CRM, en CSV o Excel, con la fecha de la exportación en el nombre, y el historial de la fecha de cierre si el CRM lo exportaAugusto, Valeria
20-comite/Las actas y los paquetes del comité comercial, con el pronóstico que se compromete para el periodoAugusto
30-evidencia/Las propuestas enviadas, las órdenes de compra y las actas de aceptación, con el id de la oportunidad al inicio del nombreAugusto
40-cotizaciones/Las cotizaciones y los pedidos con su precio, su descuento y su aprobación, con el id de la cotización al inicio del nombreValeria
50-comisiones/La liquidación de comisiones de cada periodo, con el periodo en el nombreValeria

estado-comercial/ · Lo que escriben Augusto y Valeria: la configuración, la ficha de cada periodo, los informes y los índices. Ninguna persona lo edita, y ningún agente escribe fuera de aquí.

Las fuentes9 de 9 verificadas

El rol, desde O*NET; cada exportación, desde la documentación de Salesforce y de HubSpot, campo por campo. Nada se construye sobre una fuente por verificar.

  • F-01

    O*NET · 11-2022.00 Sales Managers

    Datos de 2026 (O*NET OnLine) · onetonline.org ↗

    Verificada
  • F-02

    Salesforce · Field Reference · Opportunity

    La referencia publicada al 28 de octubre de 2026 · developer.salesforce.com ↗

    Verificada
  • F-03

    Salesforce · Object Reference · OpportunityFieldHistory

    La página de la versión 192.0 de la referencia · developer.salesforce.com ↗

    Verificada
  • F-04

    HubSpot · HubSpot's default deal properties

    Artículo actualizado el 29 de septiembre de 2026 · knowledge.hubspot.com ↗

    Verificada
  • F-05

    HubSpot · Export records

    Artículo actualizado el 2 de abril de 2026 · knowledge.hubspot.com ↗

    Verificada
  • F-06

    Microsoft · Dynamics 365 · Opportunity table/entity reference

    Página actualizada el 19 de septiembre de 2026 · learn.microsoft.com ↗

    Verificada
  • F-07

    Microsoft · Power Apps · Export data to Excel

    Página actualizada el 5 de agosto de 2025 · learn.microsoft.com ↗

    Verificada
  • F-08

    Zoho CRM · Standard Fields in Deals

    La página publicada al 30 de octubre de 2026; no muestra fecha de actualización · help.zoho.com ↗

    Verificada
  • F-09

    Zoho CRM · Export CRM Data

    La página publicada al 30 de octubre de 2026; no muestra fecha de actualización · help.zoho.com ↗

    Verificada
En el repositorio7 enlaces

Instalación, configuración y términos

Se instala en minutos. Antes del primer análisis, aceptas los términos.

Tres pasos y ninguno exige editar un archivo. Se instala solo el agente del rol que tienes: Augusto funciona sin Valeria y Valeria sin Augusto. Si instalas los dos, se encuentran solos por el estado de la entidad, y Valeria encuentra las fichas de Fidel y de Clara: no hay nada que conectar.

Paso 1

Instalar

  1. 01Personalizar → Explorar plugins → Personal.
  2. 02Pulsa + → Agregar marketplace desde GitHub.
  3. 03Escribe josenanez/criterio.
  4. 04Instala el agente de tu rol: Augusto (El pronóstico) o Valeria (De la venta a la factura).

Para recibir cada versión nueva, activa una vez la actualización automática: en /plugin, Marketplaces → criterio → Enable auto-update. Sin eso, la versión instalada no cambia sola.

Qué necesita de ti

  • Una carpeta con la documentación, como esté. Una carpeta desordenada es el caso normal.
  • Un plan pago de Claude, y la aplicación de escritorio si los documentos viven en tu equipo.
  • Quince minutos para cada uno.
Paso 2

Configurar

Cada agente trae su comando de configuración. Mira tus carpetas, hace pocas preguntas y te muestra un primer resultado sobre tus propios documentos.

/criterio-sales:sales-setup

  1. 1Cuál de las carpetas que encuentra es la comercial de la entidad
  2. 2La entidad, su país y el periodo
  3. 3De qué CRM sale cada exportación, y qué columna trae cada dato si es otro
  4. 4La tabla de etapas, con el documento que exige cada una
  5. 5Cuántos días detienen una oportunidad y cuántas veces puede correrse un cierre
  6. 6Los términos

Cómo pregunta

  • Una pregunta a la vez. Nunca un formulario.
  • Cada pregunta trae una respuesta sugerida, y «no sé» es una respuesta válida.
  • No pregunta lo que puede averiguar mirando la carpeta.
  • No te pide escribir una ruta: busca la carpeta, te la propone con la razón y, si dices que sí, la marca con un archivo visible para que la reconozcas a primera vista.
  • Nadie edita la configuración a mano: si quieres cambiar algo, lo dices en la conversación.

Ninguno se programa solo. Cada uno trae el comando que un reloj invoca (sales-wake, revenue-wake), y alguien lo pone una vez en una tarea programada. Si tu organización no quiere corridas desatendidas, se corren a mano.

/criterio-sales:sales-setupAsí se ve la configuración de Augusto
AugustoSoy Augusto, el pronóstico de Criterio. Pongo el embudo al lado de su evidencia y digo qué pronóstico no tiene respaldo; no califico a quien vende ni fijo la meta. Encontré una carpeta que parece la comercial de una entidad: comercial/901234567-almacenes-del-valle, con tres exportaciones del CRM, del 1 y el 16 de octubre y del 3 de noviembre. ¿Es esa?
Recorrido ilustrativo sobre el material de prueba de la familia, antes de su ronda con los agentes: una cadena de almacenes de prueba en Colombia, con tres exportaciones de Salesforce, su historial de campos y el acta del comité comercial. No sale nada de tu navegador.
Paso 3

Los términos

Un descargo en un repositorio no lo lee nadie. Por eso la advertencia llega a quien corre el agente y a quien recibe después el documento, en cuatro capas que implementa cada agente.

  1. 1

    Una aceptación por versión

    Cada versión de la familia se acepta de nuevo y deja en tu equipo un comprobante en Markdown y PDF, con la huella SHA-256 de los términos y la del propio comprobante. Hasta que la de la versión instalada quede registrada, el agente responde preguntas pero no produce análisis. Nunca la asume ni la infiere de que sigas hablando.

  2. 2

    En cada informe

    Todo informe lleva al pie que es un borrador, según qué documentos, cuántos campos quedaron sin dato y cuántas contradicciones siguen abiertas. El documento circula por correo y llega a un comité: la advertencia viaja con él.

  3. 3

    Al inicio de cada corrida

    Antes del primer hallazgo dice qué fichas cargó, cuándo se actualizaron y si alguna está vieja o falta.

  4. 4

    En la nota legal

    Los términos completos, la nota legal y el registro de versiones —qué cambió en cada una, qué términos la rigen y su huella— se publican en este portal, y cada comprobante remite a ellos.

Lo que acuerdas, en llano

  • Recibes borradores de trabajo listos para revisar, y cada versión llega probada: su evidencia es pública.
  • Cada dato trae su cita: quien decide lo comprueba en el documento original en segundos.
  • Trabaja con lo que está escrito; lo que se acordó fuera de los documentos lo aporta tu equipo.
  • Tus documentos se procesan en la plataforma de IA donde lo ejecutas; tu organización decide qué carpetas entran.
  • Garantía y responsabilidad: las de la licencia Apache 2.0.
  • Cada versión se acepta de nuevo y deja un comprobante en Markdown y PDF. Si alguien lo modifica, su huella SHA-256 deja de coincidir y pierde validez.

Términos versión 1.3, del 2026-10-28, para la versión 0.3.1 de la familia. Cada versión nueva de la familia pide aceptar de nuevo.

Nota legal y registro de versiones →

Apache 2.0

El método, el esquema de la ficha, el código que calcula y los criterios de aceptación, completos y sin condiciones. Úsalo dentro de tu organización sin pedir permiso, adáptalo, y construye la capacidad que te falta: el agente de una función lo debe escribir quien conoce el trabajo.

Qué no hace

  • Produce borradores de trabajo, no decisiones.
  • Sabe lo que se escribió, no lo que se habló fuera de los documentos.
  • Los dos se probaron con el motor y con los agentes en 15 entidades de Colombia, México, Chile, Ecuador y Perú; la última ronda es la 2. Su primer uso sobre la documentación de una organización concreta es el paso siguiente.
Ver el repositorio ↗

Preguntas frecuentes

Lo que suele preguntar quien llega a la familia

Qué es

¿Qué hacen Augusto y Valeria?

Augusto pone el embudo del CRM al lado de su evidencia y el pronóstico al lado de lo que lo sostiene: qué oportunidad no tiene el documento que exige su etapa, cuál está detenida, cuál corre su cierre, cuánto de lo comprometido tiene respaldo y cómo va lo cerrado contra la meta. Valeria pone cada venta al lado de su política, su contrato y su factura: el descuento contra su nivel de aprobación, lo ganado contra los contratos de Fidel, lo firmado contra las facturas de Clara y la comisión contra el plan.

¿Reemplazan al responsable comercial?

No. Procesan y contrastan. El pronóstico que se compromete, el descuento que se aprueba, la meta y la comisión los decide siempre una persona.

¿Califican a los vendedores?

No. La señal es de la oportunidad, no de quien la lleva. Ningún reporte ordena ni compara a las personas del equipo, y si alguien pide el pronóstico o la meta por vendedor, el agente lo dice y no lo arma.

¿Qué no hacen nunca?

No escriben ni cambian nada en el CRM, no contactan a un cliente, no aprueban un descuento ni una excepción de precio, no fijan una meta y no liquidan ni corrigen una comisión.

Cómo se usa

¿Se conectan a mi CRM?

No. Procesan lo que el CRM exporta, en CSV o Excel, con la fecha de la exportación en el nombre. Una conexión directa sería otra decisión, con su revisión de seguridad.

¿Qué CRM sirve?

Salesforce y HubSpot, cada uno con su lector verificado contra la documentación que publica: los campos de la oportunidad de Salesforce y las propiedades del negocio de HubSpot. Cualquier otro CRM sirve con su exportación en CSV o Excel y el mapeo de columnas que deja el setup. Microsoft Dynamics y Zoho, con su propio lector, están en la hoja de ruta.

¿Cómo sabe que una oportunidad no tiene evidencia?

Por la tabla de etapas de la organización: cada etapa dice qué documento exige —la propuesta enviada, la orden de compra— y una etapa exige también lo de las anteriores. El agente lleva a la ficha cada documento de la carpeta de evidencia con su oportunidad y su tipo, y el motor cruza.

¿Cómo sabe que un cierre se corrió?

Comparando cada exportación con la anterior: cada vez que la fecha de cierre de una oportunidad abierta pasa a una posterior, cuenta. Si el CRM exporta el historial de campos, como Salesforce, cuenta desde el historial.

¿De dónde sale el pronóstico comprometido?

Del acta o el paquete del comité comercial: el agente lleva a la ficha el valor que se comprometió para el periodo, con su cita. Si el acta no compromete un valor, el reporte dice que falta y no lo inventa.

¿Necesito a Fidel y a Clara?

Para el cruce de lo ganado con lo firmado y lo facturado, sí: Valeria toma el contrato de las fichas de Fidel y la factura de las de Clara, y no vuelve a procesarlos. Lo demás —el embudo, el pronóstico, la meta, el descuento— funciona sin ellos.

¿Cuánto tarda el primer resultado?

En los primeros quince minutos, sales-setup reconoce cada exportación del CRM y deja ver el embudo contra su evidencia, y revenue-setup deja ver lo ganado contra lo firmado y lo facturado.

¿En qué países sirve?

La primera versión se prueba en Colombia y México. Ecuador, Perú y Chile, que ya están en el registro de países de las demás familias, siguen en la hoja de ruta.

Los datos

¿Guardan los datos de contacto de mis clientes?

No. La ficha guarda la cuenta y la oportunidad, no el correo ni el teléfono de una persona, y el motor marca como problema una ficha que los traiga.

¿Se publican las comisiones?

No, por omisión. Son la remuneración de personas identificables: el reporte de comisiones no sale en Rostrum salvo que la configuración de Valeria lo diga.

¿Dónde se procesan mis documentos?

En la infraestructura de la plataforma de IA, no solo en tu equipo. Confirma que sea admisible bajo tus políticas antes de apuntarla a material confidencial.

El estado

¿Está lista para usar?

Sí: se puede instalar, en su versión 0.3.0, y todavía no se ha lanzado. El motor pasa su prueba determinista sobre material sintético de Colombia, México, Ecuador, Perú y Chile. Los dos agentes pasaron sus dos rondas con una clave que no ven.

¿Es estable?

Sí, desde la 0.3.0, porque su evidencia lo dice (decisión 0020): con las dos rondas, el piso del margen de confianza del 95 % es 98,0 % en señales y 95,1 % en datos, sobre la corrida más reciente de cada entidad del material, y ningún control levanta una señal. Lo calcula el código desde las rondas; el número de la versión no lo dice.

Las mismas respuestas viven en el repositorio, en families/criterio-cco/PREGUNTAS.es.md.

Apoya el trabajo

Si Criterio te generó valor, ayúdanos a seguir construyéndolo.

Criterio seguirá siendo código abierto. Una contribución voluntaria ayuda a financiar pruebas, documentación y nuevas capacidades sin cambiar el acceso al software.

Es una contribución voluntaria. No desbloquea funciones, no compra consultoría y no crea una relación de asesoría.

Apoyar Criterio

Elige el monto y cómo quieres realizar tu contribución.

Elige un monto

Selecciona tu país para ver los métodos de pago disponibles.

dLocal Go cubre actualmente Latinoamérica, Indonesia, Malasia, Kenia y Nigeria. La cobertura global se incorporará por separado.

La idea

Lo que se comprometió en el comité comercial siempre quedó escrito. Nadie lo había puesto al lado de lo que lo sostiene.

Dos agentes que procesan el embudo y las cotizaciones no te entregan un control que nunca construiste. Te muestran, cada semana, qué pronóstico no tiene respaldo, qué descuento no tiene su aprobación y qué venta no llegó a la factura, y dejan la decisión donde estaba: en una persona.

Principios

Enfoque
Exportaciones, nunca sistemas.
Compromiso
Generar, difundir y conservar el conocimiento es una obligación profesional.
Qué no es
No reemplaza al responsable comercial ni a su equipo, y no decide por ellos: no fija metas, no aprueba descuentos, no liquida comisiones, no contacta clientes y no califica a quien vende.
Licencia
Apache 2.0.
Qué viene
Su lanzamiento. Lo que sigue después está en su hoja de ruta.
Nota legal y registro de versiones →

José Ñáñez