Unidad 01

Diseñar una automatización antes de programarla

Definir una tarea automatizable con alcance, entradas, salidas, precondiciones y efectos controlados antes de escribir código.

Estado: No iniciada

Objetivo

Definir una tarea automatizable con alcance, entradas, salidas, precondiciones y efectos controlados antes de escribir código.

Conceptos canónicos

  • B2-U01-AUTOMATION-SCOPE — Alcance de la automatización: delimita exactamente qué elementos puede leer, crear, modificar o mover el script y qué queda fuera de su responsabilidad.
  • B2-U01-INPUT-OUTPUT-CONTRACT — Contrato de entrada y salida: especifica qué datos recibe la automatización, en qué formato y qué resultado debe producir.
  • B2-U01-PRECONDITIONS — Precondiciones: condiciones que deben cumplirse antes de actuar, como existencia de una ruta, formato válido o destino accesible.
  • B2-U01-SIDE-EFFECTS — Efectos secundarios: cambios observables producidos fuera del cálculo interno, como crear, mover, renombrar o borrar archivos.
  • B2-U01-IDEMPOTENCE — Idempotencia: repetir la automatización sobre el mismo estado no debe producir duplicaciones ni daños adicionales.
  • B2-U01-DRY-RUN — Dry-run: simulación que muestra las acciones previstas sin aplicarlas.

Patrón de trabajo

observar → validar → planificar → ejecutar → verificar

Práctica

Diseñar la organización de una carpeta sin modificarla: detectar candidatos, validar reglas y mostrar el plan.

Errores típicos

Modificar antes de validar; asumir rutas fijas; mezclar lectura y escritura; no prever la segunda ejecución.