Framework Interno v1.0

Discovery Session
Framework

Metodología estructurada para extraer, documentar y clasificar procesos de negocio de un cliente — incluyendo los que nunca mencionó.

1

El Problema

Cuando un proyecto de software falla repetidamente a pesar de tener código funcional, el problema rara vez es técnico. Es un gap de traducción entre cómo opera el cliente y cómo el desarrollador interpretó esa operación. Estos son los 4 patrones más comunes:

Procesos No Declarados

El cliente asume que ciertas cosas son obvias. Nunca las menciona porque para él “así se hace siempre.” El desarrollador no pregunta porque no sabe que existen.

Ejemplo: Arqueos de caja que generan saldos negativos legítimos.

Procesos que Mutan

Se acuerda una regla de negocio. Se implementa. El cliente la cambia — a veces sin avisar, a veces verbalmente, a veces porque “siempre quiso otra cosa.”

Ejemplo: Fondos de socios pasan de agregados a separados sin requerimiento formal.

Supuestos Implícitos

El modelo mental del cliente no coincide con el del desarrollador. Ambos creen que están de acuerdo, pero interpretan lo mismo de forma distinta.

Ejemplo: “Deducir de ganancias” para el cliente implica salida real de caja; para el dev es solo descuento en el corte.

Resistencia a Mejoras

La agencia intenta optimizar el proceso del cliente. El cliente lo rechaza porque quiere SU proceso, no uno “mejor.” El resultado: se implementó algo que nadie quiere.

Ejemplo: Se rediseña el flujo de pagos para ser más eficiente, pero el cliente opera con pasos manuales intencionales.

“El software no falla porque está mal programado.
Falla porque traduce mal la realidad del cliente.”
2

Pre-Sesión — Preparación

Checklist del Facilitador

  • Tener el sistema abierto en un dispositivo visible para el cliente (pantalla compartida o presencial)
  • Revisar TODOS los procesos core del sistema — saber qué hace cada botón
  • Listar los bugs/quejas reportados por el cliente (agrupados por proceso, no por fecha)
  • Preparar una lista de procesos a cubrir (mínimo los que tienen bugs activos)
  • Tener abierto un documento para captura en vivo (Google Doc, Notion, o el HTML de contratos operativos)
  • Grabar la sesión (audio mínimo, video ideal — pedir permiso al cliente)
  • Bloquear 2–3 horas sin interrupciones
  • Llevar la Matriz de Clasificación impresa o en otra pantalla
“No vienes a arreglar ni a mejorar.
Vienes a extraer y documentar.”
Mindset del facilitador — las soluciones vienen después, no durante.

Estructura de Tiempo Recomendada

Bloque Duración Actividad
Apertura 10 min Contexto, reglas de la sesión, expectativas
Discovery 90–120 min Show & Tell proceso por proceso
Fantasmas 20 min Preguntas de procesos ocultos
Cierre 15 min Resumen, clasificación, próximos pasos

Reglas de la Sesión (comunicar al cliente al inicio)

  1. Toda decisión se documenta en el momento. Si no queda escrito, no existe.
  2. No hay respuestas incorrectas. Queremos entender cómo opera realmente, no cómo debería operar.
  3. Si algo cambió desde que lo definimos, es válido. Solo necesitamos saberlo.
  4. Hoy no se arregla nada. Hoy se entiende. Los fixes vienen después.
3

Metodología Show & Tell

Para cada proceso, se siguen 3 pasos. El facilitador muestra, el cliente describe, y juntos documentan el delta.

1

MOSTRAR — “Así funciona hoy”

El facilitador abre el sistema y ejecuta el proceso completo frente al cliente. Sin explicar por qué se hizo así — solo mostrar qué pasa cuando se presiona cada botón.

Objetivo: Que el cliente vea la realidad actual, no lo que cree que existe.

2

ESCUCHAR — “Descírbeme tu proceso”

El cliente describe paso a paso cómo hace esta operación en su día a día. El facilitador no interrumpe, no corrige, no sugiere. Solo escucha y anota.

Clave: Si el cliente dice algo que contradice lo implementado, no defender el código. Documentar la diferencia.

3

DOCUMENTAR EL DELTA — “¿Qué no coincide?”

Comparar lo que el sistema hace vs. lo que el cliente espera. Cada diferencia se clasifica inmediatamente usando la Matriz de Clasificación (sección 5).

Regla: Cada delta es un hallazgo. No se juzga, no se prioriza aún. Solo se documenta.

4

Guión del Facilitador

Estas son las preguntas exactas que se usan en cada proceso. No son sugerencias — son un script. Seguirlo asegura que no se salten pasos críticos.

Apertura del Proceso (repetir para cada uno)

Script
[Nombre], te voy a mostrar cómo funciona [proceso] hoy en el sistema. Después te pido que me describas cómo lo haces tú en tu operación diaria. Lo que buscamos es encontrar las diferencias entre lo que existe y lo que necesitas.

Preguntas Base (después del demo)

1
“¿Esto coincide con cómo lo haces tú en tu operación diaria?”
2
“Descírbeme paso a paso cómo haces [proceso] desde cero, como si yo no supiera nada.”
3
“¿Hay algún paso que hagas fuera del sistema? ¿En Excel, en papel, de memoria, en WhatsApp?”
4
“¿Hay excepciones o casos especiales que manejes diferente?”
5
“¿Hay algo que el sistema hace que NO debería hacer?”
6
“¿Hay algo que el sistema NO hace que SÍ necesitas?”

Preguntas de Sondeo Profundo

Usar cuando el cliente da respuestas cortas o genéricas. Estas preguntas obligan a pensar en los bordes:

A
“¿Qué pasa cuando el número no cuadra? ¿Qué haces?”
B
“¿Alguien más usa esta parte del sistema? ¿Cómo?”
C
“¿Esto ha cambiado desde que empezamos el proyecto? ¿Cómo era antes?”
D
“¿Hay algún reporte o cálculo que haces manualmente relacionado con esto?”
E
“Si pudieras cambiar UNA cosa de este proceso, ¿cuál sería?”
F
“¿Qué información le pides a alguien más que el sistema no tiene?”
G
“¿Cuánto tiempo te toma esto sin el sistema? ¿Y con el sistema?”

Preguntas Prohibidas (NO hacer durante discovery)

  • “¿Pero no habíamos quedado en que...?” — No defender acuerdos previos. Solo documentar la diferencia.
  • “Eso es fácil de arreglar” — No prometer soluciones en el momento.
  • “Eso no se puede hacer” — No cerrar puertas. Todo se documenta primero.
  • “¿Por qué lo cambiaste?” (tono acusatorio) — En vez: “¿Cómo evolucionó esto con el tiempo?”
5

Matriz de Clasificación en Vivo

Cada hallazgo se clasifica inmediatamente durante la sesión. Esto evita que todo se convierta en una lista amorfa de “cosas por arreglar.”

Categoría Significado Acción Responsable
BUG El código no hace lo que se acordó en su momento Fix técnico sin costo adicional Agencia
GAP Nunca se habló, nadie lo definió, pero el cliente lo necesita Definir regla de negocio + evaluar implementación Ambos
MUTACIÓN Se acordó X, el cliente cambió a Y (con o sin aviso) Renegociar scope + documentar cambio Cliente
FANTASMA Proceso que el cliente hace fuera del sistema y nunca mencionó Evaluar si sistematizar o dejar manual Ambos
MEJORA El cliente quiere funcionalidad nueva que no estaba en el scope Cotizar como feature adicional Cliente

¿Por qué clasificar en vivo?

  • Transparencia: El cliente ve cómo se categoriza cada hallazgo. No hay sorpresas después.
  • Responsabilidad compartida: GAPs y MUTACIONES no son “errores de la agencia.” Son descubrimientos conjuntos.
  • Priorización natural: Los BUGs se arreglan primero. Las MEJORAS se cotizan. Los FANTASMAS se evalúan.
  • Protección de scope: Las MUTACIONES documentadas evitan “pero yo siempre quise esto” meses después.

Cómo comunicar la clasificación al cliente

Script
Perfecto, esto que me describes lo voy a clasificar como un [GAP/MUTACIÓN/BUG] — significa que [explicación sin culpa]. Lo documento y después vemos cómo se resuelve. ¿Estás de acuerdo con esta clasificación?

Si el cliente no está de acuerdo con la clasificación, escuchar su argumento. Si tiene razón, reclasificar. Si no, explicar con calma y dejar la clasificación final pendiente (marcar como “en disputa”).

6

Protocolo Anti-Mutación

Las decisiones que se toman hoy deben sobrevivir mañana. Este protocolo asegura que cada acuerdo quede documentado, fechado y firmado para que no mute sin registro.

Las 4 Reglas Anti-Mutación

Si no está escrito, no existe. Las decisiones verbales no cuentan. Todo se captura en el momento con fecha y contexto.
Si cambió, se documenta el cambio. La decisión anterior no se borra — se marca como “reemplazada por” con la nueva versión y la razón.
Ambas partes confirman. Después de documentar, leer la regla en voz alta y confirmar: “¿Estamos de acuerdo en que así funciona?”
Un cambio = un registro. Si el cliente pide cambiar algo que ya está implementado, no es un “arreglito” — es una mutación con impacto. Se evalúa antes de ejecutar.

Formato de Decisión en Vivo

Leer en voz alta
Entonces lo que estamos confirmando es: para el proceso de [nombre], la regla es que [regla específica]. ¿Esto es correcto? ¿Hay alguna excepción?

Plantilla — Registro de Decisión

Fecha
Proceso
Regla
Excepciones
Decidió
Reemplaza
Confirman
7

Descubrimiento de Procesos Fantasma

Los procesos fantasma son las operaciones que el cliente ejecuta fuera del sistema y que nunca mencionó porque asume que “eso no va en la plataforma.” Son la fuente #1 de bugs inexplicables.

Preguntas de Detección

Hacer estas preguntas AL FINAL de cada proceso, no al inicio. El cliente necesita estar en modo “operación real” para recordar:

1
“¿Qué haces en Excel o Google Sheets que está relacionado con esto?”
2
“¿Qué cálculos haces de cabeza o en calculadora?”
3
“¿Hay reportes que generas manualmente para ti o para alguien más?”
4
“¿Hay dinero que entra o sale que no se registra en el sistema?”
5
“¿Tienes otro sistema, app, cuaderno o herramienta donde llevas algo que aquí no está?”
6
“¿Hay procesos que solo tú sabes hacer? ¿Qué pasa si no estás?”
7
“¿Alguna vez has hecho algo por fuera del sistema porque no encontraste cómo hacerlo aquí?”
8
“¿Hay cosas que le pides a tu contador, asistente o chofer que el sistema debería poder hacer?”

Señales de Proceso Fantasma

Si el cliente dice alguna de estas frases, hay un fantasma escondido:

  • “Eso lo llevo aparte
  • “Eso no va ahí
  • “Es que eso es diferente
  • “Esas unidades son mías, no del negocio
  • “Eso lo hago yo a mano
  • “Sí, pero aparte de eso también hago...”

Cuando detectes una señal: no la dejes pasar. Seguir con “Cuéntame más sobre eso” hasta que el proceso completo esté documentado.

8

Formato de Cierre

Resumen de Hallazgos (llenar al final)

_
Bugs
_
Gaps
_
Mutaciones
_
Fantasmas
_
Mejoras

Script de Cierre

Script
[Nombre], en esta sesión encontramos [N] hallazgos: [X] bugs que corregimos nosotros, [X] gaps que definimos juntos, [X] cambios que evolucionaron desde el acuerdo original, [X] procesos que no estaban en el sistema, y [X] mejoras nuevas.

Los bugs los arreglamos sin costo. Los gaps los implementamos según lo que acordamos hoy. Las mejoras las cotizamos por separado. ¿Te parece bien este plan?

Checklist de Cierre

  • Todas las decisiones están documentadas con fecha y responsable
  • Todos los hallazgos tienen clasificación (BUG/GAP/MUTACIÓN/FANTASMA/MEJORA)
  • Las ambigüedades que quedan abiertas están listadas con responsable de resolver
  • Se definió fecha de siguiente revisión/entrega
  • El cliente confirmó el resumen y el plan de acción
  • Se envió el resumen por escrito al cliente (email/WhatsApp) dentro de 24 horas

Plantilla de Mensaje Post-Sesión

Template
Hola [Nombre], te comparto el resumen de nuestra sesión de hoy:

Procesos revisados: [lista]
Hallazgos: [N] total ([X] bugs, [X] gaps, [X] mutaciones, [X] fantasmas, [X] mejoras)

Decisiones confirmadas:
1. [decisión 1]
2. [decisión 2]

Pendientes por definir:
1. [pregunta abierta 1]

Siguiente paso: [acción + fecha]

Si algo de lo que anotamos no coincide con lo que platicamos, avísame antes de que empecemos a implementar. Gracias por tu tiempo.
9

Plantillas de Captura

Estas plantillas se llenan durante la sesión. Cada hallazgo, cada decisión, cada proceso fantasma tiene su formato para que nada se pierda.

Plantilla A — Hallazgo de Sesión

Categoría BUG / GAP / MUTACIÓN / FANTASMA / MEJORA
Proceso
Descripción
Qué hace hoy
Qué debería hacer
Decisión
Responsable
Fecha

Plantilla B — Contrato Operativo

Proceso
Trigger ¿Qué acción del usuario dispara este proceso?
Entradas ¿Qué datos necesita el usuario ingresar?
Regla dura Regla que NUNCA se rompe
Resultado UI ¿Qué ve el usuario después?
Resultado DB ¿Qué cambia en la base de datos?
Excepciones
Confirman

Plantilla C — Proceso Fantasma

Proceso
Dónde lo hace Excel / Papel / Cabeza / WhatsApp / Otra app
Frecuencia Diario / Semanal / Mensual / Cuando pasa X
Tiempo manual ¿Cuánto le toma hacerlo manualmente?
Impacto ¿Qué pasa si no se hace? ¿Qué se pierde?
Sistematizar Sí (incluir en scope) / No (dejar manual) / Evaluar