4 de cada 5
líderes de ventas y de finanzas no acertaron al menos un pronóstico trimestral de ventas en el último año; el 52 % de los líderes de ventas dice que su pronóstico se desvía un 10 % o más
80 de cada 100 líderes
Criterio CCO
La función comercial
La evidencia antes de la decisión
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
4 de cada 5
líderes de ventas y de finanzas no acertaron al menos un pronóstico trimestral de ventas en el último año; el 52 % de los líderes de ventas dice que su pronóstico se desvía un 10 % o más
80 de cada 100 líderes
28 %
de su semana dedica un vendedor a vender; el 72 % se va en otras tareas, sobre todo gestionar los negocios y capturar datos
28 de cada 100 horas
84 %
de los líderes de ventas dice que la analítica comercial influyó menos de lo esperado en el desempeño; el 44 % señala la mala calidad de los datos
84 de cada 100 líderes
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
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
| Desde | País | Entidades del material | Sus rondas | Señales · datos |
|---|---|---|---|---|
| Ronda 1 | Colombia | Retail, Tecnología, Entidad de control | Ronda 1 | 41 de 41 señales · 15 de 15 datos |
| Ronda 1 | México | Manufactura, Servicios profesionales, Entidad de control | Ronda 1 | 39 de 39 señales · 15 de 15 datos |
| Ronda 2 | Ecuador | Retail, Tecnología, Entidad de control | Ronda 2 | 38 de 38 señales · 15 de 15 datos |
| Ronda 2 | Perú | Manufactura, Servicios profesionales, Entidad de control | Ronda 2 | 40 de 40 señales · 15 de 15 datos |
| Ronda 2 | Chile | Retail, Tecnología, Entidad de control | Ronda 2 | 39 de 39 señales · 15 de 15 datos |
El mapa de avance
5 países probados
Fronteras: Natural Earth, dominio público.
Lo que se probó aquí
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
42 documentos · 5 defectos sembrados a propósito
44 documentos · 5 defectos sembrados a propósito
28 documentos y ningún defecto: cualquier señal sería una falla
Evolución
Las entidades y sus defectos se escriben en el repositorio, en tests/criterio-cco/generar.py.
Criterio · Familia CCO
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 · 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
Los dos, uno por uno
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
Nunca
Escribe en el CRM, contacta a un cliente, fija la meta, compromete el pronóstico o califica a quien vende.

Sus comandos, por grupo
sales-setupsales-wakepipeline-scanpipeline-checkforecast-checktarget-check6 comandos · 4 skills
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
/criterio-sales:sales-setup, deja su configuración en .criterio/comercial/<entidad>/ y marca su carpeta raíz con _CRITERIO_COMERCIAL.txt./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

Lo que te cuesta hoy
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.
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
Horas por semana en cada tarea
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
Escribe el costo mensual de cada grupo para ver lo que cuesta.
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
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.
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.
Ronda 11
Ronda 1 · verificación2
Ronda 23
Ronda 2 · verificación4
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ís | Entidades | Ronda | Datos de las fichas | Señales encontradas | Señales correctas | Controles sin falsas alarmas |
|---|---|---|---|---|---|---|
| Colombia | 3 | 1 | 15 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 |
| Ecuador | 3 | 2 | 15 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ú | 3 | 2 | 15 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 |
| Chile | 3 | 2 | 15 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éxico | 3 | 1 | 15 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.
De dónde vinieron
Para auditar
El detalle completo de cada corrida. Se abre cada bloque por separado.
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 prueba | Agente · comandos | Señales | Datos de las fichas | Tokens |
|---|---|---|---|---|
| entidad de controlRonda 1 · Colombia | Augusto, Valeria · 4 | 0 / 0 | 5 / 5 | 3,2 M |
| entidad de controlRonda 1 · México | Augusto, Valeria · 4 | 0 / 0 · +2 | 5 / 5 | 2,9 M |
| entidad de controlRonda 1 · México · verificación | Augusto, Valeria · 4 | 0 / 0 | 5 / 5 | 2,9 M |
| entidad de controlRonda 1 · México · verificación | Augusto, Valeria · 4 | 0 / 0 | 5 / 5 | 2,9 M |
| manufacturaRonda 1 · México | Augusto, Valeria · 4 | 20 / 20 | 5 / 5 | 3,1 M |
| retailRonda 1 · Colombia | Augusto, Valeria · 4 | 21 / 21 | 5 / 5 | 2,8 M |
| servicios profesionalesRonda 1 · México | Augusto, Valeria · 4 | 15 / 19 | 5 / 5 | 3,2 M |
| servicios profesionalesRonda 1 · México · verificación | Augusto, Valeria · 4 | 19 / 19 | 5 / 5 | 3,3 M |
| tecnologíaRonda 1 · Colombia | Augusto, Valeria · 4 | 16 / 20 | 5 / 5 | 3,5 M |
| tecnologíaRonda 1 · Colombia · verificación | Augusto, Valeria · 4 | 20 / 20 | 5 / 5 | 3,2 M |
| entidad de controlRonda 2 · Chile | Augusto, Valeria · 4 | 0 / 0 | 5 / 5 | 2,6 M |
| entidad de controlRonda 2 · Ecuador | Augusto, Valeria · 4 | 0 / 0 | 5 / 5 | 3,1 M |
| entidad de controlRonda 2 · Perú | Augusto, Valeria · 4 | 0 / 0 · +1 | 5 / 5 | 2,9 M |
| entidad de controlRonda 2 · Perú · verificación | Augusto, Valeria · 4 | 0 / 0 | 5 / 5 | 2,9 M |
| manufacturaRonda 2 · Perú | Augusto, Valeria · 4 | 20 / 20 | 5 / 5 | 3,2 M |
| retailRonda 2 · Chile | Augusto, Valeria · 4 | 19 / 19 | 5 / 5 | 3,2 M |
| retailRonda 2 · Ecuador | Augusto, Valeria · 4 | 18 / 18 | 5 / 5 | 3,2 M |
| servicios profesionalesRonda 2 · Perú | Augusto, Valeria · 4 | 20 / 20 | 5 / 5 | 3,1 M |
| tecnologíaRonda 2 · Chile | Augusto, Valeria · 4 | 20 / 20 | 5 / 5 | 3 M |
| tecnologíaRonda 2 · Ecuador | Augusto, Valeria · 4 | 20 / 20 | 5 / 5 | 3,1 M |
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
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
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
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.
0.1.0
LiberadaLiberada el 2026-10-28
Augusto y Valeria, construidos, con el motor probado
Prueba
El motor contra la clave de todo el material: seis entidades de Colombia y México, con sus controles
0.2.0
LiberadaLiberada el 2026-10-29
La ronda completa con los agentes
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
Último liberado
0.3.0
LiberadaLiberada el 2026-10-29
Trae todo lo anterior y sus correcciones
Ecuador, Perú y Chile, y Microsoft Dynamics y Zoho
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.
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 extraeEl 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 extraeLa 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 extraeEl 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 calculaSeñ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 calculaNingú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
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.
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.
Exportaciones, nunca sistemas
Ningún agente se conecta al CRM, y ninguno escribe en él.
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.
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.
Ningún agente decide
El pronóstico, el descuento, la meta y la comisión son de una persona.
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
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.
En orden de importancia. El primero deja la configuración que los demás necesitan.
sales-setupLa configuración, el inventario y el formato de cada exportación del CRM
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 cierrepipeline-scanLa ficha del periodo al día, con lo que cambió en el embudo y las señales nuevas
10-crm/ completo, 20-comite/ y 30-evidencia/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 fichapipeline-checkCada oportunidad contra su evidencia: la que no la tiene, la detenida y la que corre su cierre
10-crm/, las anteriores, la tabla de etapas de 00-referencia/ y la ficha del periodoforecast-checkEl pronóstico comprometido contra lo que lo sostiene, oportunidad por oportunidad
10-crm/ y la tabla de etapas de 00-referencia/target-checkLa meta del periodo contra lo cerrado al corte, por línea
00-referencia/ y la última exportación de 10-crm/sales-wakeLo que toca hoy en el embudo; si no toca nada, se calla
10-crm/, un acta nueva del comité, el cierre del periodo que se acerca y una revisión semanalshare-findingsUn resumen sin datos para compartir, solo si dices que sí
.criterio/corridas/En orden de importancia. El primero deja la configuración que los demás necesitan.
revenue-setupLa configuración, el inventario y las cuentas que faltan para cruzar con Fidel y Clara
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 firmadodeal-scanLa ficha del periodo al día, con las cotizaciones nuevas y las señales nuevas
40-cotizaciones/ completo y la última exportación de 10-crm/discount-checkCada descuento contra su política y su aprobación
00-referencia/ y la ficha del periodowon-to-invoiceDe lo ganado a lo firmado y a lo facturado: lo que se quedó en el camino
10-crm/, la tabla de cuentas de 00-referencia/, las fichas de los contratos de Fidel y las de la facturación de Claracommission-checkCada comisión liquidada contra la que da el plan
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 Clararevenue-wakeLo que toca hoy de la venta a la factura; si no toca nada, se calla
share-findingsUn resumen sin datos para compartir, solo si dices que sí
.criterio/corridas/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_evidenceUna oportunidad está en una etapa y no tiene el documento que esa etapa exige: la propuesta enviada, la orden de compra
stalled_opportunityUna oportunidad abierta no tiene actividad registrada en los días configurados
close_date_slippedLa fecha de cierre de una oportunidad se movió más veces de las configuradas
forecast_unsupportedLo comprometido supera lo que suman las oportunidades con evidencia, ponderadas por su etapa, más de la tolerancia configurada
target_vs_closedLo cerrado al corte se aparta de la meta del periodo, prorrateada por los días transcurridos, más del umbral
Valeria · 4
discount_outside_policyUn 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_contractUna oportunidad ganada no tiene su contrato firmado en la ficha de Fidel
signed_without_invoiceUn contrato firmado no tiene su factura en la ficha de Clara dentro del plazo de facturación
commission_differs_from_planLa comisión liquidada no es la que da el plan sobre lo cerrado y facturado
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
| Carpeta | Qué va | Agente |
|---|---|---|
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 cliente | Augusto, 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 exporta | Augusto, Valeria |
20-comite/ | Las actas y los paquetes del comité comercial, con el pronóstico que se compromete para el periodo | Augusto |
30-evidencia/ | Las propuestas enviadas, las órdenes de compra y las actas de aceptación, con el id de la oportunidad al inicio del nombre | Augusto |
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 nombre | Valeria |
50-comisiones/ | La liquidación de comisiones de cada periodo, con el periodo en el nombre | Valeria |
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í.
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.
O*NET · 11-2022.00 Sales Managers
Datos de 2026 (O*NET OnLine) · onetonline.org ↗
Salesforce · Field Reference · Opportunity
La referencia publicada al 28 de octubre de 2026 · developer.salesforce.com ↗
Salesforce · Object Reference · OpportunityFieldHistory
La página de la versión 192.0 de la referencia · developer.salesforce.com ↗
HubSpot · HubSpot's default deal properties
Artículo actualizado el 29 de septiembre de 2026 · knowledge.hubspot.com ↗
HubSpot · Export records
Artículo actualizado el 2 de abril de 2026 · knowledge.hubspot.com ↗
Microsoft · Dynamics 365 · Opportunity table/entity reference
Página actualizada el 19 de septiembre de 2026 · learn.microsoft.com ↗
Microsoft · Power Apps · Export data to Excel
Página actualizada el 5 de agosto de 2025 · learn.microsoft.com ↗
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 ↗
Zoho CRM · Export CRM Data
La página publicada al 30 de octubre de 2026; no muestra fecha de actualización · help.zoho.com ↗
Instalación, configuración y 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.
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
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
Cómo pregunta
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.
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.
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.
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.
Al inicio de cada corrida
Antes del primer hallazgo dice qué fichas cargó, cuándo se actualizaron y si alguna está vieja o falta.
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
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
Preguntas frecuentes
Qué es
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.
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.
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.
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
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.
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.
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.
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.
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.
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.
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.
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
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.
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.
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
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.
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
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.
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
José Ñáñez