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.