Guía práctica · Andrómeda

Tu primer agente:
de tarea repetitiva a automatización

Guía práctica para convertir una tarea en una automatización construida, probada y desplegada con un agente de programación.

Qué vas a conseguir

Dejar de ser tú quien inicia el trabajo

Pides manualmente→Delegas a un sistema

Pedir

Abres la IA, escribes, esperas, obtienes un resultado. Ahorras tiempo, pero tú sigues siendo el disparador.

Delegar

Algo ocurre, el sistema trabaja y aparece el resultado, sin que tengas que acordarte de pedirlo.

Al terminar esta guía tendrás un procedimiento para llevar una tarea repetitiva desde una frase hasta una automatización que corre por sí sola, con pruebas y con forma de vigilarla.

Empieza con cuatro cajas

Cuatro preguntas para cualquier tarea

Disparador

¿Qué hace que empiece?

Información

¿Qué necesita recibir o conocer?

Trabajo

¿Qué tiene que hacer?

Resultado

¿Qué debe existir cuando termina?

plantilla-cuatro-cajas.txt
DISPARADOR: ______________________________
INFORMACIÓN: _____________________________
TRABAJO: _________________________________
RESULTADO: _______________________________
Ejemplo. Un reporte diario que llega por un formulario. Disparador: pulsar Enviar. Información: el texto del reporte. Trabajo: leerlo con reglas fijas, marcar lo que falta y calcular totales. Resultado: un resumen con estado OK o REVISAR.
Antes de activar. Si una caja sigue incompleta, puedes aclararla o hacer un prototipo. Antes de conectar cuentas o producir efectos externos, declara la incógnita, el supuesto y qué quedará en revisión.
Elige el nivel correcto

Tres niveles de automatización

Nivel 1

Programado

Sé qué debe ocurrir y sé cuándo. Ejemplo: un resumen cada viernes.

Nivel 2

Por evento

No sé cuándo pasará, pero sé qué hacer cuando pase. Ejemplo: llega un reporte.

Nivel 3

Agéntico

Conozco el objetivo, pero no todos los pasos.

¿Necesito que la IA decida esto cada vez, o ya conozco los pasos?

Más autonomía no significa automáticamente una mejor automatización. Cada decisión que dejas al sistema en tiempo de ejecución añade variabilidad, coste, errores, permisos y mantenimiento. Construir con un agente no vuelve agéntico al sistema terminado.
El procedimiento completo

De una frase a un sistema funcionando

  1. TareaLa describes en lenguaje natural.
  2. AclaraciónEl agente te hace preguntas hasta tener las cuatro cajas.
  3. DiseñoPropone la solución mínima y espera tu aprobación.
  4. ConstrucciónEscribe el código y las pruebas.
  5. Prueba localSe ejecuta todo en tu computadora primero.
  6. GitGuardas la historia de cambios.
  7. GitHubEl código queda alojado en un repositorio.
  8. DespliegueEl código se envía al servicio que ejecuta tareas.
  9. Prueba alojadaSe repite la prueba fuera de tu computadora.
  10. DiagnósticoSi algo falla, se busca la causa.
  11. CorrecciónSe arregla y se vuelve a probar.
  12. ActivaciónRecién ahora se enciende el disparador real.
  13. ObservaciónSigues mirando ejecuciones y errores.
Tú decides. El agente propone y construye, pero conectar cuentas, desplegar, activar y manejar claves requiere tu autorización.
Instrucción 1

Aclarar antes de construir

Pégala en Claude Code o Codex y después escribe la tarea. El agente debe hacer preguntas, no crear archivos.

instruccion-1-aclarar.txt
Quiero convertir una tarea real en una automatización.

No construyas nada todavía.

Primero ayúdame a aclarar el problema. Identifiquemos:
1. DISPARADOR: qué hace que el trabajo empiece.
2. INFORMACIÓN: qué necesita recibir o conocer.
3. TRABAJO: qué pasos debe realizar.
4. RESULTADO: qué debe existir cuando termine.

Hazme las preguntas mínimas necesarias para eliminar ambigüedades. Clasifica el caso como programado, disparado por un evento o potencialmente agéntico. Dime si los pasos pueden ser deterministas o qué decisión debe tomarse durante la ejecución.

No escribas código hasta que yo apruebe el diseño.
Instrucción 2

Diseñar la solución mínima

instruccion-2-disenar.txt
Con lo que ya aclaramos, propón la arquitectura mínima para automatizar esta tarea.

Prioridades: solución sencilla, no agregar servicios innecesarios, no usar autonomía agéntica si los pasos ya están definidos, separar claramente lo local de lo remoto, identificar credenciales sin pedirme valores, explicar pruebas antes y después del despliegue y explicar qué podría salir mal.

Todavía no implementes. Muéstrame flujo completo, componentes, disparador, entrada, procesamiento, salida, secretos necesarios, pruebas, coste o recursos y riesgos. Termina pidiéndome aprobación.
Si el agente propone demasiado: ¿Cuál es la versión mínima que resuelve el problema? Quita todo lo que no sea imprescindible.
Instrucción 3

Construir y probar

instruccion-3-construir.txt
Diseño aprobado.

Implementa la versión mínima acordada.

No cambies partes del proyecto que no sean necesarias; no introduzcas credenciales en el código; no subas archivos de entorno; no inventes datos cuando falte información; agrega validaciones y pruebas; prueba primero localmente; diagnostica y corrige defectos; no despliegues todavía.

Al terminar, explica qué construiste, qué archivos cambiaste, qué pruebas ejecutaste, qué falló, qué corregiste y qué sigue sin estar comprobado. Después detente y espera mi autorización.

Acepta

  • Crear o editar archivos dentro del proyecto.
  • Ejecutar pruebas locales.

Rechaza por ahora

  • Cualquier despliegue.
  • Cualquier cosa con claves o archivos de entorno.
  • Instalar herramientas globales.
  • Tocar carpetas ajenas al proyecto.
Prueba antes de confiar

Que funcione una vez no es suficiente

CasoQué compruebas
Caso normalCon datos completos y correctos, el resultado es el esperado.
Dato faltante o defectuosoEl sistema avisa qué falta en lugar de inventarlo. Ejemplo: marca REVISAR.
Ausencia de datosNo rompe ni produce un resultado falso.
Entradas adversarialesResponde con error claro, no se corta de golpe.
Errores externosQuedan registrados y se entienden.
Efectos externosNo envía, borra, cobra ni registra nada indebido.
Regla útil. Con la misma entrada, un sistema determinista debe dar siempre el mismo resultado.
Versiona y protege

El código puede viajar. La llave no.

Git

Guarda la historia de cambios en tu computadora.

GitHub

Aloja el código; puede ser privado.

Variables de entorno

Guardan secretos locales. Nunca se comparten ni se suben.

Despliega y vuelve a probar

Que funcione aquí no prueba que funcione allá

Claude Code / Codex→código→prueba local→Git→GitHub→Trigger.dev→prueba alojada
GitHub

Aloja el código. No ejecuta el sistema.

Trigger.dev

Ejecuta las tareas desplegadas, fuera de tu computadora.

En la arquitectura demostrada, el despliegue se lanza con un comando desde tu computadora. Subir código a GitHub no actualiza la tarea por sí solo. En Trigger.dev: crea o verifica cuenta y proyecto, despliega una versión probada, revisa el historial de ejecuciones, ejecuta el caso alojado y confirma cómo detenerlo antes de activar un horario real.

Después del despliegue: repite caso normal, dato defectuoso y, si aplica, ausencia de datos. La transcripción de Nate se usó para completar esta explicación; no necesitas salir de la guía para seguir el recorrido.

Si tu automatización vive en n8n

Trabaja sobre una copia de desarrollo del workflow. Conecta tus propias credenciales dentro de n8n, prueba los nodos y mantén el workflow inactivo hasta verificar rutas normales y de error. Para usar Claude con n8n mediante MCP, configura localmente la URL de tu instancia y tu API key, comienza en solo lectura y nunca pegues esa key en un chat o repositorio.

Video de conexión Claude/n8n MCP compartido en Clase 2

Activar no es el final

Después de activar, sigues mirando

Observa→detecta errores→diagnostica→corrige→vuelve a probar→aprende
Caso de Clase 2 · plantilla reutilizable

Workflow de facturas: descarga una estructura adaptable

La clase trabajó un workflow de Gmail hacia Siigo. Esta descarga conserva la estructura y conexiones de 24 nodos, pero no contiene parámetros, credenciales, IDs, endpoint ni datos operativos. Se importa para configurar y adaptar en una copia de desarrollo.

ConservaNo incluye
Nombres, tipos, posiciones y conexiones de los 24 nodos. El workflow sigue inactivo.Configuración de nodos, reglas, código operativo, credenciales, IDs de Gmail/Telegram, endpoint o datos de Siigo.
Lo demostrado: lectura de XML y aviso de pendiente; rutas para XML ausente, duplicado y error. No demostrado: credenciales/API de Siigo disponibles, creación final de factura, activación vigente o resultados en producción.
Hoja de trabajo

Diseña tu primera automatización

Rellena los campos y copia el resultado para pegarlo en tu agente. Lo escrito se guarda solo en este navegador.

Lista final antes de producción

Marca cada punto antes de activar

0 de 13 marcados

Siguiente paso

Escoge una tarea. Solo una.

Elige una tarea repetitiva real, de las que todavía inicias tú, y pásala por las cuatro cajas. Si ya conoces los pasos, empieza determinista. Luego usa la Instrucción 1 y deja que el agente te haga las preguntas.

¿Por qué sigo siendo yo el que tiene que iniciar esto?