Tema

Fuente

Tamaño

Ancho de texto

Interlineado

Acento de los controles

0 de 0 0%
MÓDULO 1.2

Empieza por el resultado aprobado

Haz ingeniería inversa de una entrega y transforma preferencias en criterios.

Al final: Producir una especificación de salida y un conjunto inicial de casos.

6 tópicos
55 min estimación con práctica
6 ejercicios comentados
1 verificación final
1

Elija un ejemplo que merezca repetirse

Salida aprobada Decisiones usadas Datos de origen Receta candidata
Retrocede en la investigación; luego escribe el procedimiento en el orden de ejecución.

Qué es

La ingeniería inversa empieza con una salida que consideras buena y con las entradas que la produjeron. Un informe aislado muestra la apariencia, pero no explica filtros, fórmulas y decisiones. Guarda también el origen de los datos.

Por qué aprender

Copiar solo el formato puede reproducir un error elegante. Antes de convertir el ejemplo en referencia, verifica números, fechas y contexto. Un buen ejemplo de referencia tiene calidad conocida, no solo aprobación por impresión general.

Conceptos clave

Salida aprobadadestino.
Entrada originalorigen.
Decisionescamino.
Validaciónconfianza en el ejemplo.
EJEMPLO COMENTADO · 1.2.1
Informe esperado
Período observado: 2026-09-14 a 2026-09-17
Total: R$ 500,00
Tienda: R$ 320,00 | Sitio: R$ 180,00
Pendientes: ninguno en el archivo de ejemplo.

✓ Haz así

Confirma la suma del ejemplo antes de usarlo como plantilla (gabarito).

✗ Evita este error

Elegir la salida más bonita sin conocer los datos.

Practica antes de revelar

Enumera tres características obligatorias de ese informe.

Ver respuesta comentada

Período explícito; suma exacta de R$ 500,00; totales por canal que concilian con el total. El modo de redactar la introducción puede variar.

2

Entrevista el proceso, no solo el estilo

Fuente Filtro Cálculo Presentación
Cada etapa necesita una pregunta que exponga la decisión humana.

Qué es

Pregunta cómo se hizo el trabajo: qué fuentes entraron, qué registros se excluyeron, cómo se trataron los duplicados y quién aprobó el resultado. Haz preguntas que expliciten decisiones escondidas, en lugar de pedir solo un “estilo profesional”.

Por qué aprender

Quien ejecuta una tarea durante años toma atajos sin darse cuenta. El agente no conoce esos atajos. Una entrevista corta recupera el conocimiento tácito y ayuda a descubrir dependencias que deben existir antes de la automatización.

Conceptos clave

Origende dónde vino cada dato.
Transformaciónqué regla cambió el dato.
Excepcióncuándo la regla no basta.
Aceptaquién decide y con qué evidencia.
EJEMPLO COMENTADO · 1.2.2
1. ¿Este total incluye cancelaciones?
2. ¿Qué fecha define la semana: compra o pago?
3. ¿Dos registros iguales son duplicados o dos ventas?
4. ¿Qué verificas antes de compartir?

Del concepto a la acción

  1. Fuente: identificar la condición inicial.
  2. Filtro: aplicar la decisión descrita.
  3. Cálculo: comprobar el efecto en el ejemplo.
  4. Presentación: registrar la evidencia de salida.

✓ Haz así

Registra “no sabemos” cuando no existe la respuesta.

✗ Evita este error

Deducir la regla de negocio mirando una sola línea.

Practica antes de revelar

Crea una pregunta que impida la suma indebida de reembolsos.

Ver respuesta comentada

“¿Los valores negativos representan reembolsos autorizados? ¿Deben descontar el total o aparecer en una sección separada?” La respuesta se convierte en una regla explícita de negocio.

3

Convierte preferencias en criterios de aceptación

Pedido vago Criterio Evidencia Aprobar o corregir
Cada criterio debe apuntar a un lugar de la salida o a una prueba.

Qué es

“Quiero algo bueno” no permite reprobar una salida de forma consistente. Divide la calidad en ítems observables: presencia del período, correspondencia entre datos y tabla, tamaño del resumen y claridad de las pendientes. Separa los obligatorios de las preferencias.

Por qué aprender

Los criterios anticipados evitan cambiar el nivel después de ver qué modelo generó el resultado. También ayudan a distinguir un bloqueo serio, como un número inventado, de una mejora editorial, como una frase larga.

Conceptos clave

Obligatoriofallar bloquea la entrega.
Deseablemejora la utilidad.
Objetivochequeo reproducible.
Editorialjuzgamiento con ejemplos.
EJEMPLO COMENTADO · 1.2.3
Criterio | Evidencia
Total correcto | suma independiente de las líneas
Período explícito | encabezado con dos fechas
Claridad | el lector identifica el total y los pendientes sin buscar
Sin invención | afirmaciones rastreables a la entrada

✓ Haz así

Define fallas bloqueantes antes de la primera evaluación.

✗ Evita este error

Aprobar por el número de ítems del checklist sin mirar el contenido.

Practica antes de revelar

Reescribe “informe bien organizado” como dos criterios.

Ver respuesta comentada

“El total y el período aparecen antes de los comentarios” y “los pendientes quedan en una sección propia, con acción propuesta”. Ambos vuelven la organización ininspeccionable (no verificable).

4

Separa lo que es fijo de lo que puede variar

Contrato estable Datos variables Juzgamiento limitado Salida adaptada
La consistencia significa cumplir el contrato; no significa repetir palabras.

Qué es

La plantilla debe preservar la información necesaria y permitir adaptación donde ayuda. En el informe, los nombres de las columnas y las reglas de suma son fijos; la redacción de los comentarios depende del contenido. Esta división será la base del nivel de libertad.

Por qué aprender

Congelar todo genera texto genérico. Dejar todo abierto permite omitir números importantes. Una buena receta combina un esqueleto estable con decisiones editoriales delimitadas, sin intentar prever cada frase.

Conceptos clave

Estructura fijasecciones obligatorias.
Regla fijacálculo definido.
Variaciónsíntesis de la semana.
Límiteno inferir causas sin fuente.
EJEMPLO COMENTADO · 1.2.4
FIJO: período → total → canales → pendientes.
VARIABLE: observaciones sobre concentración por canal.
PROHIBIDO: “la campaña causó el alza” sin datos de la campaña.

✓ Haz así

Da ejemplos de dos redacciones diferentes que serían aceptables.

✗ Evita este error

Exigir la misma conclusión cuando los datos cambiaron.

Practica antes de revelar

Si solo hubiera un canal en el archivo, ¿la skill debería crear una comparación entre canales?

Ver respuesta comentada

No. Informa que hay un único canal y limita el análisis. Preservar el contrato exige adaptar el comentario a la entrada, no fabricar variedad.

5

Arma tus primeros casos de referencia

Normal Ausente Ambiguo Reservado
La cobertura se mide por las situaciones relevantes, no solo por el número de archivos.

Qué es

Un conjunto de referencia reúne entradas, salidas esperadas o criterios, y el motivo de cada caso. Incluye el camino común, un dato ausente y una situación ambigua. El conjunto representa la tarea, no solo tu ejemplo favorito.

Por qué aprender

Una corrección que resuelve el archivo original puede romper un archivo vacío. Los casos variados revelan ese efecto temprano. Reserva algunos casos para la evaluación final, sin usarlos para editar la instrucción en cada intento.

Conceptos clave

Normaldemuestra el camino principal.
Límiteprueba el borde de la regla.
Inválidoprueba la respuesta a error.
Reservadoreduce un ajuste excesivo a los ejemplos.
EJEMPLO COMENTADO · 1.2.5
C01: cuatro ventas válidas → total 500,00.
C02: sin columna valor → error claro, sin informe.
C03: CSV vacío → informar ausencia de datos.
C04: valor negativo → seguir política explícita.

Del concepto a la acción

  1. Normal: identificar la condición inicial.
  2. Ausente: aplicar la decisión descrita.
  3. Ambiguo: comprobar el efecto en el ejemplo.
  4. Reservado: registrar la evidencia de salida.

✓ Haz así

Anota por qué cada caso está en el conjunto.

✗ Evita este error

Llamar a una única ejecución de benchmark definitivo.

Practica antes de revelar

Agrega un caso que detecte error de separador decimal.

Ver respuesta comentada

Una línea con el valor “120,50” debe ser rechazada por el contrato con punto decimal, o normalizada por una regla deliberada. En el kit, la decisión es rechazar con un mensaje claro.

6

Escribe el briefing que convierte en skill

Ejemplo Briefing Ejecución manual Ajuste
La primera receta debe ser ejecutable antes de recibir más detalles.

Qué es

El briefing reúne finalidad, entradas, salida, pasos, límites y criterios. Aún no necesita ser una skill instalada. Primero verifica si otra persona puede ejecutar el proceso con esas instrucciones sin depender de ti en cada etapa.

Por qué aprender

Este ensayo encuentra ambigüedades antes de atribuirlas al modelo. Si ni tú puedes decir cuándo termina el trabajo, la automatización solo acelera la indefinición. Usa un briefing pequeño y completo como punto de partida.

Conceptos clave

Finalidad en una frase.
Pasos con verbos claros.
Criterios ligados a la salida.
Excepciones con respuesta esperada.
EJEMPLO COMENTADO · 1.2.6
Transforme el CSV proporcionado en un informe semanal local.
Valide fecha, canal y valor; calcule sin alterar la entrada.
Produzca período, total, canales y pendientes.
Verifique las sumas y entregue relatorio.md + qa.json.
Si falta un campo obligatorio, explique y detenga el cálculo.

✓ Haz así

Pídele al agente que liste ambigüedades antes de formalizar.

✗ Evita este error

Pedir “crea la skill perfecta” sin proporcionar referencia.

Practica antes de revelar

Usa la plantilla de briefing del kit para describir tu propio proceso.

Ver respuesta comentada

La entrega debe incluir una entrada de ejemplo, una salida deseada y al menos tres criterios. Si falta una regla de negocio, registra el pendiente en lugar de completarlo por imaginación.

VERIFICACIÓN SIN BLOQUEO

Verifique su comprensión

Recibiste un informe bonito, pero sin el período. ¿Cuál es el diagnóstico?

¿Qué te llevas de este módulo?

Producir una especificación de salida y un conjunto inicial de casos.

  • Elija un ejemplo que merezca repetirse.
  • Entrevista el proceso, no solo el estilo.
  • Convierta preferencias en criterios de aceptación.
  • Separe lo que es fijo de lo que puede variar.
  • Arme sus primeros casos de referencia.
  • Escriba el briefing que se convierte en skill.

Próxima acción: guarde el ejercicio en su laboratorio y registre lo que todavía necesita revisión.

Referencia de este módulo: transcripción proporcionada y fuentes y notas técnicas del curso.