Al terminar esta lección
- Registrar una sesión de shadowing separando observación, interpretación y pregunta para el debrief.
- Reconstruir handoffs y esperas a partir de observaciones y documentos, y dibujar un AS-IS que muestre quién decide y dónde hay vueltas.
- Detectar una colisión semántica en el vocabulario del cliente y resolverla en un glosario sin elegir una definición al azar.
- Formular reglas candidatas con identificador, condición, resultado, frontera, fuente, autoridad y estado, y detectar cuando una regla fue inventada en el código.
3. El negocio real aparece en los detalles
La entrevista te cuenta cómo la gente piensa que trabaja. La observación, los documentos y los casos excepcionales te muestran cómo el negocio realmente decide.
En el módulo anterior saliste de la primera reunión con un pedido concreto, el 48172, y con una lista de desconocidos con dueño. Ahora vas a buscar evidencia de otro tipo: mirar trabajo real, abrir las planillas que nadie mencionó y convertir lo que aprendiste en reglas que un desarrollador pueda implementar y un test pueda defender. El recorrido de esta lección sigue el orden en que se hace en campo:
- Observar una ejecución real (shadowing).
- Leer los documentos que esa ejecución usa (arqueología documental).
- Dibujar el AS-IS cuando aparecen handoffs y vueltas.
- Fijar el vocabulario para que dos áreas no hablen de cosas distintas con la misma palabra.
- Escribir reglas verificables, con su fuente y su estado.
- Triangular cuando dos fuentes se contradicen.
3.1 Shadowing: mirar el trabajo sin convertirlo en teatro
Problema que resuelve. En una entrevista, la vendedora te dice “cargo el pedido en el ERP y listo”. Cuando la mirás trabajar, abre WhatsApp Web, copia códigos a una hoja temporal, pega la lista en el ERP y, cuando dos códigos no existen, los busca en pedidos históricos del cliente. Nadie mintió: la entrevista captura el relato; el shadowing captura la secuencia. Cuando una tarea es frecuente o compleja, observar una ejecución real suele aportar más que una segunda hora de entrevista.
Definición operativa. Shadowing es observar una ejecución real de una tarea, sin dirigirla, registrando hechos con hora y dejando las preguntas para un debrief corto posterior. No interrumpís cada treinta segundos. Registrás tiempo, entrada, herramienta, decisión, handoff, espera, corrección y dato ausente. La pregunta aparece después del hecho, no antes: “Vi que abriste dos veces la planilla de descuentos, ¿qué estabas comparando? ¿Qué habría hecho que eligieras otro precio?”.
Ejemplo en Nexo. Así se ve una nota de campo útil. Fijate que cada línea de observado es algo que una cámara podría haber filmado, y que lo interpretado vive en otro campo, con una pregunta pendiente:
id: NOTA-01
sesion: shadowing-ventas-01
observador: analista
tarea: "Cargar un pedido que llegó por WhatsApp"
eventos:
- t: "08:17"
observado: "Abre WhatsApp Web y copia 14 códigos a una hoja temporal."
herramienta: [whatsapp-web, excel-temporal]
tipo: entrada
- t: "08:21"
observado: "Pega la lista en el ERP. Dos códigos no existen; no los rechaza."
herramienta: [erp]
tipo: correccion
interpretacion: "Podría ser producto renumerado, abreviatura habitual o error real."
pregunta_debrief: "¿Cómo decidís si un código inexistente es un error o un producto renumerado?"
- t: "08:24"
observado: "Busca los dos códigos en pedidos históricos del mismo cliente."
herramienta: [erp, historial-cliente]
tipo: consulta
dato_ausente: "No hay tabla de equivalencias a mano."
- t: "08:42"
observado: "Abre PRECIOS_ESPECIALES_2026.xlsx y filtra por CUIT del cliente."
herramienta: [excel-precios-especiales]
tipo: consulta
pregunta_debrief: "¿Qué significa la columna OK y quién pone las iniciales?"
espera_total_observada: null # no se mide aún; no inventamos duraciones
Antipatrón. El shadowing se vuelve teatro cuando la persona observada actúa para vos (“así se hace según el procedimiento”) o cuando vos corregís mientras mira. También cuando tus notas mezclan lo que viste con lo que concluiste: “la vendedora no confía en el ERP” no es una observación, es una interpretación que necesita su pregunta de debrief.
Efecto observador. Que alguien te mire cambia cómo se trabaja: la persona se acerca al procedimiento ideal, va más despacio o evita los atajos que usa todos los días (es el llamado efecto Hawthorne). No se elimina; se reduce y se tiene en cuenta:
- Antes de empezar, explicá para qué observás y pedí permiso: venís a entender el proceso, no a evaluar a la persona.
- Observá más de una ejecución, y si podés en días distintos: los atajos reaparecen cuando la persona se acostumbra a tu presencia.
- Contrastá lo observado con rastros que no dependen de que estés ahí: horas del historial de WhatsApp, cambios de estado en el ERP, marcas en las planillas.
- Si una ejecución se ve mucho más prolija que lo que muestran esos rastros, anotalo como pregunta para el debrief, no como conclusión.
Nota de campo débil vs. nota de campo útil
“Carga lenta. La vendedora trabaja con muchas herramientas y no confía en el ERP. Hay mucho retrabajo en la carga de pedidos.”
“08:21 pega 14 códigos en el ERP; dos no existen. 08:24 los busca en pedidos históricos del cliente. Dato ausente: no hay tabla de equivalencias a mano. Pregunta de debrief: ¿cómo distinguís un código renumerado de un error?”
Cómo se verifica. Una nota de campo es buena si otra persona, sin haber estado, puede reconstruir la secuencia y señalar qué parte es hecho y cuál es lectura tuya. Probalo con este ejercicio:
Hecho, interpretación o pregunta para el debrief
Clasificá cada línea de las notas de campo de Nexo.
08:42 La vendedora abre PRECIOS_ESPECIALES_2026.xlsx y filtra por CUIT.
La vendedora no confía en el ERP para precios.
¿Qué significa la columna OK y quién pone las iniciales?
Dos de los 14 códigos no existen en el ERP; los busca en pedidos históricos del cliente.
El Excel personal de la vendedora es la tabla de equivalencias oficial.
Vi que abriste la planilla dos veces: ¿qué estabas comparando?
Pasaron siete minutos entre que copió los códigos (08:17) y empezó a buscarlos en pedidos históricos (08:24).
3.2 Arqueología documental: las reglas que viven en Excel y PDF
Problema que resuelve. Los documentos operativos contienen conocimiento que nadie verbaliza en una entrevista. Una planilla puede revelar categorías de cliente, una fórmula puede codificar un descuento, un PDF puede mostrar estados reales y una cadena de WhatsApp puede revelar quién autoriza una excepción. El objetivo no es copiar esos artefactos al software, sino usarlos como evidencia del dominio.
Definición operativa. Arqueología documental es inventariar cada artefacto que interviene en una decisión y registrar, para cada uno: quién lo mantiene, cuándo se actualiza, qué decisión sostiene, qué semántica esconde y qué riesgo introduce. Un Excel no es una base de datos mal hecha que debamos copiar. Es evidencia de que alguien necesitó conservar cierto conocimiento. Mirá fórmulas, validaciones, columnas ocultas, colores, propietario, frecuencia de actualización y los casos que no entran en la estructura.
Ejemplo en Nexo. La planilla de acuerdos de precio, PRECIOS_ESPECIALES_2026.xlsx (la misma “planilla de acuerdos históricos” que apareció en la reunión 1), revela que algunos acuerdos tienen fecha de vencimiento, otros no, y varios se expresan como precio neto en lugar de porcentaje. Esa diferencia cambia el dominio y la autoridad del cálculo. Este es el inventario documental que sostiene esa afirmación:
artefactos:
- id: DOC-01
nombre: PRECIOS_ESPECIALES_2026.xlsx
mantiene: "Responsable comercial"
actualizacion: "Manual, sin frecuencia fija"
sostiene_decision: "Precio de una línea cuando el cliente tiene acuerdo"
columnas: [CUIT, SKU, precio, vencimiento, OK]
semantica_oculta:
- "OK = 'lo habló alguien de dirección'; no siempre se sabe quién."
- "Algunas filas no tienen vencimiento; esos acuerdos se siguen aplicando 'hasta nuevo aviso'."
- "Algunos acuerdos son precio neto; otros son porcentaje sobre lista."
riesgo: "Precio incorrecto o vencido aplicado sin rastro de quién lo aprobó."
pregunta_abierta: "¿Qué fuente prevalece si contradice al ERP?"
- id: DOC-02
nombre: "Excel personal de equivalencias de SKU"
mantiene: "Cada vendedor (copia propia)"
ejemplo: "A-184 → A-184B desde 2026-05-01"
riesgo: "Cada copia puede divergir; no hay vigencia explícita en todas las filas."
- id: DOC-03
nombre: "Planilla de administración con columna 'comprometido'"
mantiene: "Administrativa"
actualizacion: "Cada mañana, desde un PDF de saldos del ERP"
la_consulta: "Laura (administración/crédito), antes de autorizar"
sostiene_decision: "Si un pedido entra o no en el límite de crédito"
riesgo: "Se desactualiza durante el día; los cheques se cargan al final."
Una vez que tenés el inventario, podés hacerle preguntas a los datos. Si el cliente te entrega una exportación del Excel, unos minutos de SQL exploratorio valen más que una hora de debate sobre cuántas filas “están mal”. Supongamos que la exportación se cargó en una tabla temporal de análisis (no del sistema futuro):
-- Tabla de trabajo cargada desde PRECIOS_ESPECIALES_2026.xlsx (solo para análisis)
-- precios_especiales(cuit text, sku text, valor numeric, vencimiento date, ok text)
-- 1. Acuerdos sin vencimiento: ¿cuántos y de qué clientes?
SELECT cuit, count(*) AS acuerdos_sin_vencimiento
FROM precios_especiales
WHERE vencimiento IS NULL
GROUP BY cuit
ORDER BY acuerdos_sin_vencimiento DESC;
-- 2. Mismo cliente y SKU con más de un acuerdo vigente: ¿cuál gana?
SELECT cuit, sku, count(*) AS acuerdos
FROM precios_especiales
WHERE vencimiento IS NULL OR vencimiento >= current_date
GROUP BY cuit, sku
HAVING count(*) > 1;
-- 3. ¿Precio neto o porcentaje? Heurística: un 'valor' menor a 100 parece porcentaje.
-- Es una hipótesis para preguntar, no una regla.
SELECT CASE WHEN valor < 100 THEN 'probable porcentaje' ELSE 'probable precio neto' END AS tipo,
count(*) AS filas
FROM precios_especiales
GROUP BY 1;
-- 4. Filas sin iniciales en OK: no se sabe quién las autorizó
SELECT count(*) AS sin_aprobador
FROM precios_especiales
WHERE ok IS NULL OR btrim(ok) = '';
Ninguna de esas consultas decide nada. Producen preguntas con cifras para llevar a Comercial: “la consulta 2 devuelve filas, ¿cuál de los dos acuerdos aplica?”. El criterio de decisión sigue siendo de quien tiene autoridad sobre el precio.
Crear una tabla special_prices con las mismas columnas del Excel “porque ahí está todo” copia los defectos: la columna OK sin identidad, el valor ambiguo entre neto y porcentaje, la falta de vencimiento. Primero entendés qué decisión sostiene cada columna; después, en el módulo de especificación, decidís qué modelo la representa.
3.3 Dibujar el AS-IS solo cuando ayuda a revelar handoffs
Nexo parece tener un flujo lineal hasta que lo recorremos con roles. El pedido puede saltar de ventas a crédito, volver a ventas, pasar a depósito, volver por una sustitución y recién entonces entrar en facturación. Un mapa AS-IS vale la pena porque permite discutir quién decide, dónde se espera y qué dato cruza cada handoff. No es UML; es un diagrama conceptual de proceso.
Un AS-IS útil cumple tres condiciones. Tiene carriles por rol, para que cada decisión tenga dueño visible. Tiene vueltas, es decir, flechas que regresan, porque el trabajo real vuelve atrás. Y no incluye todavía componentes del sistema futuro: si aparece una “API de precios” en el mapa, ya estás diseñando. Este es el pedido 48172 en forma de AS-IS conceptual:
Fijate qué muestra el diagrama que una lista de pasos esconde: hay un ciclo (d2 → v5 → c2 → v6 → d1), el pedido pasa dos veces por ventas, hay una espera de crédito con una bifurcación que nadie escribió (poca diferencia: Laura; mucha: Marta, como dijo la vendedora en la reunión 1), y la decisión de crédito depende de una planilla que no está en el ERP. Esas cosas son el tipo de hallazgo que mueve el software. El 48172 recorrió el camino “poca: sí”; las otras ramas salen de lo declarado en la reunión 1, no de este pedido.

Cómo se verifica. Otra persona tiene que poder seguir un episodio sobre el mapa, señalar quién decide cada bifurcación y marcar dónde faltan datos. Si el diagrama termina siendo una cadena limpia sin esperas ni vueltas mientras la operación real está llena de llamadas y correcciones, probablemente modelaste el procedimiento ideal y no el trabajo observado.
3.4 Construir un glosario porque la misma palabra puede esconder dos procesos
Problema que resuelve. El glosario no es un diccionario de términos técnicos. Es una herramienta para detectar colisiones semánticas. En Nexo, “pedido”, “reserva”, “confirmado”, “facturado” y “despachado” deben tener una definición que negocio y desarrollo puedan usar sin traducir mentalmente.
El caso de “confirmado”. La colisión apareció en la reunión 1: ventas llamaba “confirmado” al pedido aceptado comercialmente y depósito, al pedido “ya impreso”. El shadowing la confirma y la precisa: para ventas, “confirmado” es el pedido que ya pasó crédito; para depósito, es el que tiene la hoja impresa recibida y el stock verificado en la ubicación antes de preparar. Si desarrollo elige una definición sin hacer visible la colisión, los estados del sistema van a codificar una discusión no resuelta: el día que un pedido “confirmado” llegue a depósito sin stock físico, cada área tendrá razón según su definición.
| Área | Qué llama “confirmado” | Evento que lo dispara | Qué asume el que lo oye |
|---|---|---|---|
| Ventas | Pedido que ya pasó la evaluación de crédito | Aprobación de crédito | “El cliente ya tiene su pedido asegurado.” |
| Depósito | Pedido con la hoja impresa recibida y el stock verificado en la ubicación | Hoja recibida y stock verificado antes de preparar | “Puedo empezar a prepararlo.” |
Cuando dos áreas usan la misma palabra para cosas distintas, no se resuelve eligiendo una al azar: se documentan los dos conceptos y se negocia un nombre no ambiguo. Por ejemplo, CONFIRMADO_COMERCIAL y LISTO_PARA_PREPARAR, o cambiar el vocabulario hasta que todos reconozcan el mismo evento. Esos nombres son un ejemplo de cómo se resuelve la colisión; los estados definitivos del pedido se cierran más adelante, con el modelo de estados.
Una entrada de glosario con valor para el diseño tiene más campos que “término: definición”:
terminos:
- termino: "pedido confirmado"
estado_del_termino: COLISIÓN
significados:
- area: Ventas
definicion: "El pedido pasó la evaluación de crédito (aceptado comercialmente)."
fuente: "Reunión 1 (vendedora); relato del pedido 48172"
- area: Depósito
definicion: "La hoja impresa llegó y el stock se verificó en la ubicación antes de preparar."
fuente: "Reunión 1 (operario de depósito: 'ya impreso'); shadowing en depósito"
propuesta_de_nombres: ["CONFIRMADO_COMERCIAL", "LISTO_PARA_PREPARAR"]
quien_decide: "Dirección, con ventas y depósito en la misma reunión"
- termino: disponible
estado_del_termino: COLISIÓN
significados:
- area: Ventas
definicion: "Stock on-hand que muestra la pantalla del ERP."
- area: Depósito
definicion: "Lo que se puede prometer después de descontar lo ya reservado (marcado a mano en la pizarra)."
nota: "Fórmula candidata: onHand - reservado. 'Reservado' hoy es una marca manual en la pizarra."
Ordená el trabajo con un término en conflicto
Usá las flechas para ordenar los pasos que seguirías cuando detectás que ventas y depósito usan ‘confirmado’ de manera distinta.
- Posición 1 de 5: Con el episodio como ejemplo, proponer nombres que distingan los dos eventos (por ejemplo CONFIRMADO_COMERCIAL y LISTO_PARA_PREPARAR).
- Posición 2 de 5: Con la colisión registrada, verificar con un episodio real cuál de los significados estaba en juego, por ejemplo el pedido 48172.
- Posición 3 de 5: Llevar la propuesta a quien tiene autoridad sobre el vocabulario y registrar la decisión.
- Posición 4 de 5: Anotar cada significado con quién lo usa y de dónde lo sacaste (entrevista, observación, documento), y marcar el término como COLISIÓN en el glosario en lugar de elegir una definición.
- Posición 5 de 5: Recién entonces usar el nombre acordado en reglas, estados y criterios de aceptación.
3.5 De una frase informal a una regla verificable
Problema que resuelve. Una regla existe con o sin software. El sistema la implementa o la asiste, pero no la inventa. El error frecuente es registrar “validar crédito” como regla; eso es una intención. La regla tiene que decir qué relación entre saldo, límite, categoría y monto produce qué resultado.
Definición operativa. Una regla de negocio candidata tiene: identificador, condición, resultado (las dos ramas cuando aplica), frontera (ejemplos límite, o qué falta para tenerlos), fuente, autoridad que la confirma o que autoriza su excepción, y estado de validación. El estado es uno de tres: confirmada (alguien con autoridad la validó), provisional (hay evidencia, pero falta validar algo; es lo que en las notas aparece como “a validar”) o BLOCKED (no puede avanzar hasta que alguien con autoridad la defina). Para que una regla pueda viajar hasta los tests necesita todos esos campos o una nota explícita de qué falta.
Esta es la anatomía, escrita como un registro:
id: RN-01
enunciado: "Un cliente ESTÁNDAR no puede confirmar un pedido si saldoDeudor + totalPedido supera limiteCredito."
cuando: "categoria == ESTANDAR"
entonces:
si_supera_limite: "el pedido no se confirma"
si_no_supera: "continúa la evaluación del pedido"
frontera:
- "saldo + pedido == límite → permitido"
- "saldo + pedido == límite + 1 centavo → bloquea"
fuente:
- 'Marta, reunión 1: política declarada ("No debería pasar")'
- "Laura, reunión 1: práctica mostrada en pantalla compartida"
autoridad_que_confirma: "Laura (administración/crédito)"
autoridad_de_excepcion: "Ver RN-02 para Platino; la autorización no modifica el límite permanente"
pendiente: "Qué entra en saldoDeudor: la definición de exposición de crédito sigue abierta (U-01)"
estado: confirmada # fórmula y frontera; la definición de saldo sigue abierta
Fijate en lo que no figura como fuente: el pedido 48172. Su cliente es Platino, así que es evidencia de RN-02, no de una regla para clientes ESTÁNDAR. Usarlo para RN-01 sería tomar una excepción como prueba de la regla general.
La tabla canónica de reglas del caso Nexo, con su estado de validación al final de esta etapa, es la siguiente. Separa dos clases de reglas: las del proceso actual, que ya se observan en la operación, y las políticas o invariantes del sistema futuro, que se derivan del negocio pero hoy no existen en ningún lado. Que una regla sea una “invariante técnica derivada del negocio” describe su naturaleza, no su estado: el estado sigue siendo confirmada, provisional o BLOCKED.
| ID | Regla candidata | Frontera / ejemplo | Estado |
|---|---|---|---|
| Reglas del proceso actual: se observan hoy en Nexo | |||
| RN-01 | Cliente ESTÁNDAR no puede confirmar si saldoDeudor + totalPedido supera limiteCredito. | igual al límite: permitido; un centavo más: bloquea. | confirmada |
| RN-02 | Cliente PLATINO puede exceder el límite solo dentro de una tolerancia definida o con autorización. | la tolerancia exacta todavía no está validada. | BLOCKED |
| RN-04 | Una equivalencia de SKU solo aplica si está vigente en la fecha del pedido. | A-184 -> A-184B desde 2026-05-01. | provisional |
| Políticas e invariantes del sistema futuro, derivadas del negocio | |||
| RN-03 | El precio de una línea se calcula en servidor desde lista vigente y acuerdos autorizados. | el cliente no envía unitPrice autoritativo; la precedencia entre lista y acuerdo sigue abierta (U-02). | confirmada (el principio) |
| RN-05 | Una reserva nunca puede hacer disponible < 0 por depósito/SKU. | dos pedidos compiten por la última unidad. | confirmada (la dueña pidió evitar sobreventa; ver 3.7) |
| RN-06 | Un reenvío del mismo pedido por falta de respuesta no genera un segundo pedido. El criterio para distinguir un reenvío de un pedido repetido legítimo es DESCONOCIDO. | el cliente reenvía la foto porque no le contestaron: un solo pedido; falta el criterio para distinguirlo de un pedido repetido a propósito, algo frecuente en B2B. | provisional |
| RN-07 | Una reserva blanda (la que retiene stock mientras el pedido espera autorización) expira y libera la disponibilidad pasado un tiempo todavía no definido. | el valor del TTL (tiempo de vida de la reserva) no existe; la dueña dijo “un rato”, no “un día” (U-04). | BLOCKED |
RN-06 y RN-07 se incorporan en esta etapa porque la evidencia las pide. RN-06 aparece cuando mirás el WhatsApp de un cliente que reenvía la foto del pedido porque “no le contestaron”: sin una regla explícita, dos cargas del mismo pedido son dos pedidos. Pero no todo pedido repetido es un reenvío, y cómo distinguirlos es una pregunta para ventas. El mecanismo técnico que reconoce la misma intención (un identificador del pedido, el requestId) se define en el módulo de especificación; acá la regla queda en términos de negocio. RN-07 aparece con la evidencia del depósito (sección 3.7): si el negocio quiere sostener una reserva mientras se espera una autorización, el tiempo que puede sostenerla es una decisión que nadie tomó.
Si Nexo todavía no confirmó si la tolerancia Platino es X%, un monto fijo o depende del historial del cliente, RN-02 debe decirlo. Un número inventado para “seguir avanzando” transforma incertidumbre visible en comportamiento defectuoso. En RN-07 pasa lo mismo con el tiempo de expiración de la reserva: el estado BLOCKED es información, no un faltante a disimular.
Cómo se ve una regla cuando llega a código
Una regla bien escrita se puede traducir sin adivinar. RN-01, con su frontera, es casi una función pura. Las cifras van en centavos enteros para que el “un centavo más” sea exactamente un centavo:
export type CreditCheck =
| { kind: "within_limit" }
| { kind: "exceeds_limit"; excessCents: number };
/** RN-01: ESTÁNDAR no puede confirmar si saldo + pedido supera el límite. */
export function checkStandardCredit(input: {
balanceCents: number;
orderTotalCents: number;
creditLimitCents: number;
}): CreditCheck {
const exposure = input.balanceCents + input.orderTotalCents;
if (exposure <= input.creditLimitCents) return { kind: "within_limit" }; // frontera: igual al límite → permitido
return { kind: "exceeds_limit", excessCents: exposure - input.creditLimitCents };
}
Compará ese <= con el texto de la regla: “igual al límite: permitido; un centavo más: bloquea”. Esa frontera es la que, más adelante, se convierte en dos tests: uno con saldo más pedido exactamente igual al límite y otro con un centavo más. Una regla sin frontera obliga al desarrollador a elegir < o <= por intuición.
Ahora el caso inverso: código que ya implementa “reglas” que nadie escribió. Revisalo contra la tabla de arriba.
¿Qué reglas se inventaron en este código?
Hacé clic en las líneas que contradicen o inventan reglas de la tabla (RN-01 a RN-07).
3.6 Triangulación: cuando dos fuentes se contradicen
En una empresa nueva casi nunca existe una única fuente de verdad. El responsable comercial describe una política, el operador aplica una excepción aprendida por costumbre y el sistema heredado contiene una validación distinta. La tarea del analista no es elegir la versión que “suena más lógica”, sino registrar la contradicción y obtener evidencia suficiente para resolverla.
Para cada regla crítica buscá al menos dos fuentes independientes cuando sea razonable: entrevista + sistema, entrevista + documento, sistema + observación. Así se registra una contradicción, sin resolverla por cuenta propia:
id: TRI-01
tema: "Tolerancia de crédito de clientes PLATINO"
afirmaciones:
- fuente: "Marta (reunión 1)"
tipo: DECLARACIÓN
texto: "No debería pasar."
contexto: "Respuesta a qué pasa si la cuenta está por encima del límite."
- fuente: "Vendedora (reunión 1, min 4)"
tipo: DECLARACIÓN
texto: "Con Platino, si es poco, se pide autorización. Ayer pasó."
evidencia_ligada: EV-03
- fuente: "Audio de autorización del pedido 48172 (cliente Platino)"
tipo: HECHO
texto: "Laura autorizó por audio un pedido que superaba el límite."
- fuente: "ERP (configuración de límites)"
tipo: HECHO
texto: "Existe un único campo de límite por cliente; no hay campo de tolerancia."
contradiccion: "Política declarada por la dueña ('No debería pasar') vs. práctica relatada y documentada (un pedido Platino sobre el límite se autorizó por audio)."
no_es_contradiccion: "El ERP sin campo de tolerancia no contradice a nadie: muestra que la excepción hoy vive fuera del sistema."
quien_puede_cerrarla: "Dirección, con administración/crédito"
estado_regla: "RN-02 BLOCKED"
siguiente_paso: "Pedir a Laura tres autorizaciones recientes con montos y quién las dio."
La autoridad para resolver una contradicción depende del tema. Una regulación fiscal puede estar por encima del dueño. Un operador puede saber mejor cómo funciona el proceso actual. El responsable comercial puede decidir la política futura. Tu trabajo es identificar la naturaleza de la contradicción y llevarla a quien tiene legitimidad para cerrarla.
La vendedora declaró que con Platino, si es poco, se pide autorización. El ERP no tiene ningún campo de tolerancia. ¿Cómo queda registrada RN-02?
3.7 Nexo cambia otra vez: la reserva pasa a ser un requisito
La pizarra ya la conocías desde la reunión 1. En el shadowing, el picker precisa cómo funciona: hoy nadie “reserva” en el ERP; cuando un vendedor imprime un pedido, coloca una marca manual en la pizarra para artículos críticos, y en pedidos grandes dos vendedores pueden prometer la misma unidad. Lo nuevo es la decisión: la dueña confirma que la nueva solución sí debe evitar sobreventa, pero no define todavía cuánto tiempo puede quedar una reserva sin confirmar.
Esta decisión cambia el problema. Hasta ahora la pizarra era evidencia de un workaround; ahora la reserva es un concepto del dominio y un requisito. Antes podíamos pensar que solo había que leer stock. Ahora sabemos que el sistema debe gobernar disponibilidad concurrente. También sabemos que el TTL de una reserva no está definido (RN-07). Eso bloquea una parte del diseño, pero no impide seguir modelando la invariante: la disponibilidad no puede quedar negativa (RN-05).
Con el pedido 48172 se ve la diferencia entre el dato del ERP y la realidad que gobierna la decisión. AX-442 tiene 8 unidades on-hand en el depósito CBA. Pero la pizarra del depósito tiene 6 unidades ya reservadas (marcadas a mano) para pedidos impresos que todavía no se prepararon, y el ERP no las descuenta. El pedido 48172 pide 3.
| Dato | Valor | Quién lo conoce |
|---|---|---|
| Stock on-hand en CBA (ERP) | 8 | Cualquier vendedor, desde el ERP |
| Reservado para pedidos previos (marcas en la pizarra) | 6 | Depósito, que tiene la pizarra a la vista; quien carga un pedido no la ve desde el ERP |
Disponible real para prometer (onHand - reservado) | 2 | Nadie, hasta que el pedido llega a depósito |
| Pedido 48172 | 3 | Vendedora |
| Faltante | 1 | Depósito, a las 10:31 |
Ese faltante es una carrera digital entre pedidos, no un error de conteo: en el estante había 8, nadie mintió ni contó mal; faltaba el concepto de reserva. Más adelante vas a separar esto de la discrepancia física, cuando el stock del estante no coincide con ningún registro.
Vocabulario del módulo 3
Frente
Shadowing
Errores frecuentes
- Síntoma: tus notas dicen “el vendedor no confía en el sistema” y nadie puede verificarlo. Causa: mezclaste interpretación con observación. Corrección: dividí la nota en
observado,interpretacionypregunta_debrief, y hacé la pregunta antes de usar la conclusión. - Síntoma: el Excel se convierte en tabla con las mismas columnas. Causa: lo trataste como esquema y no como evidencia. Corrección: por cada columna anotá qué decisión sostiene, quién la mantiene y qué semántica esconde, antes de pensar en el modelo.
- Síntoma: desarrollo y depósito discuten por qué un pedido “confirmado” llegó sin stock. Causa: una colisión semántica no se hizo visible y alguien eligió una definición. Corrección: marcá el término como colisión y negociá dos nombres.
- Síntoma: la regla dice “validar crédito”. Causa: registraste una intención. Corrección: reescribila como condición, resultado, frontera y fuente; si falta alguno, anotá qué falta y quién lo resuelve.
- Síntoma: aparece una tolerancia “provisoria” en el código. Causa: se llenó un valor desconocido para destrabar el trabajo. Corrección: estado BLOCKED, parámetro sin valor productivo y pregunta con dueño.
- Síntoma: el AS-IS es una línea recta y la operación está llena de llamadas. Causa: modelaste el procedimiento ideal. Corrección: volvé a un episodio real y agregá las esperas, las vueltas y los carriles de quién decide.
Ejercicios
Del lenguaje del cliente a una regla
Ordená el pasaje de una frase informal a una regla
Ordená los pasos para transformar ‘a un cliente de años se le deja pasar’ en una regla del registro.
- Posición 1 de 6: Recién entonces traducirla a criterios de aceptación y tests.
- Posición 2 de 6: Buscar ejemplos frontera y casos que la contradigan.
- Posición 3 de 6: Registrar quién la confirma o autoriza su excepción, y el estado: confirmada, provisional o BLOCKED.
- Posición 4 de 6: Contrastar la condición y la frontera con una segunda fuente independiente (sistema, documento u observación).
- Posición 5 de 6: Capturar la frase literal con quién la dijo y en qué contexto.
- Posición 6 de 6: Separar condición y resultado: qué situación dispara qué decisión.
Reescribí ‘validar crédito’
El registro de requerimientos tiene una línea: ‘validar crédito del cliente antes de confirmar’. Reescribila como una regla verificable con id, condición, resultado, frontera, fuente y estado. Usá los datos de Nexo: cliente ESTÁNDAR, saldoDeudor, totalPedido, limiteCredito.
Resolvé la colisión de ‘disponible’
El ERP muestra 8 unidades de AX-442 en CBA. La pizarra de depósito tiene 6 reservadas (marcadas a mano). La vendedora dice ‘hay disponible’. Escribí la entrada de glosario que separa los conceptos que hoy se llaman ‘disponible’, con una definición operativa por cada uno.
IA en esta fase
Qué puede hacer el agente: comparar entrevistas con documentos, listar términos inconsistentes, señalar reglas candidatas, generar preguntas de frontera y proponer consultas SQL exploratorias sobre exportaciones.
Qué no debe decidir: que una fórmula histórica es la regla correcta, cuál es la fuente autoritativa, ni el TTL de una reserva (RN-07) ni la tolerancia Platino (RN-02).
Contexto mínimo útil: notas, ejemplos reales, extractos de planilla y una lista explícita de fuentes con fecha y propietario.
Cómo verificar: pedí al agente que cite de qué fragmento obtiene cada candidato. Luego verificá manualmente los casos que cambian dinero, stock, legalidad o autorización.
Un prompt de trabajo para extraer reglas candidatas sin que el agente las decida:
Rol: asistente de discovery. No decidís reglas de negocio.
Fuentes (cada una con id, fecha y dueño):
- NOTA-01: notas de shadowing de ventas (adjunto)
- DOC-01: extracto de PRECIOS_ESPECIALES_2026.xlsx (adjunto, 30 filas)
- ENT-01: transcripción abreviada de la primera reunión (adjunto)
Tarea:
1. Listá reglas candidatas en una tabla: id provisorio, condición, resultado,
fuente (NOTA/DOC/ENT + fragmento textual), ejemplo frontera si existe.
2. Si la fuente no alcanza para una condición o un valor, escribí
"FALTA: <qué> / pregunta: <a quién>". No completes el valor.
3. Listá contradicciones entre fuentes. No elijas una.
Restricciones: no inventes porcentajes, plazos ni umbrales. Si algo suena
razonable pero no está en las fuentes, va en "FALTA".
Cómo revisar la salida. Primero buscá números: cada porcentaje, plazo o umbral en la respuesta tiene que tener una cita textual; si no la tiene, es una invención. Después verificá a mano tres filas al azar contra la fuente citada. Por último comprobá que las contradicciones estén listadas como pares de afirmaciones y no fusionadas en una “regla final”. Si el agente sintetizó una regla donde las fuentes se contradicen, descartá esa fila y volvé a preguntar al dueño de la decisión.
Para llevarte
- Una nota de campo separa lo observado de lo interpretado; las preguntas esperan al debrief y parten de un hecho.
- Un documento operativo es evidencia de una necesidad, no un esquema para copiar: anotá dueño, frecuencia, decisión que sostiene y semántica oculta.
- Un AS-IS útil tiene carriles por rol, esperas y vueltas, y no muestra componentes del sistema futuro.
- Si dos áreas usan la misma palabra para cosas distintas, el glosario registra la colisión y se negocian dos nombres.
- Una regla verificable tiene id, condición, resultado, frontera, fuente, autoridad y estado; lo que falta se marca BLOCKED con dueño, nunca se completa con una cifra “razonable”.
- La autoridad depende del dato: el ERP, la planilla, el operador y el responsable comercial mandan cada uno sobre cosas distintas.
¿Cómo valoras el contenido técnico de esta lección?
Tu feedback nos ayuda a mejorar los laboratorios prácticos de Eje Z.