Workflows y orquestación

Hasta ahora usaste Claude Code de forma interactiva. Esta unidad lo convierte en pieza de automatización.

Modo headless. Con la bandera -p, Claude ejecuta un prompt sin sesión interactiva: procesa, imprime el resultado y termina.

claude -p "revisa este diff y resume los riesgos"

Es la base para CI: un job del pipeline puede invocar claude -p para revisar un PR, generar notas de release o clasificar un error, y publicar la salida como comentario o artefacto.

Git worktrees. Para que varios agentes trabajen en paralelo sobre el mismo repositorio sin pisarse, cada uno necesita su propia copia de trabajo. git worktree add crea directorios adicionales, cada uno con su rama, compartiendo el mismo historial:

git worktree add ../feature-x feature-x

El patrón orquestador. En trabajos complejos, un agente coordinador mantiene el hilo principal delgado: no lee decenas de archivos ni ejecuta los tests él mismo — delega. Subagentes especializados exploran, implementan y revisan, cada uno en su contexto; el orquestador recibe resúmenes, sintetiza y decide el siguiente paso.

Con esto se arman pipelines de agentes: exploración → implementación → review, donde cada etapa recibe el resumen de la anterior. La regla constante: el contexto del coordinador es un recurso escaso — cada token que entra debe ganarse su lugar.

Trabajar seguro. Cuanta más autonomía le das a un agente, más importan tus defensas. La salida de un agente es una propuesta: revisa el diff completo antes de commitear — alcance, archivos tocados, ausencia de secretos. Recuerda que todo lo que el agente lee (archivos, páginas web, issues) puede contener instrucciones maliciosas dirigidas a él (prompt injection): ese contenido es datos, no órdenes, y por eso los prompts de permiso y los hooks guardrail no se apagan "para ir más rápido". La bandera --dangerously-skip-permissions desactiva la capa de permisos por completo: solo es aceptable en entornos aislados y descartables (un contenedor sin credenciales), nunca en tu máquina de trabajo. Y no olvides qué sale de tu máquina: tus mensajes, los archivos que Claude lee y las salidas de comandos viajan al modelo — controla qué entra al contexto.

El mapa de mecanismos. A esta altura conviene nombrar cada pieza con precisión. Skill: instrucciones reutilizables que se cargan cuando el contexto las pide. Agente: un rol con contexto propio que ejecuta trabajo delegado. Hook: regla determinista del harness que corre siempre — no depende de que el modelo se acuerde. MCP: el protocolo para conectar herramientas y datos externos. Plugin: el paquete instalable que agrupa skills, agentes, hooks y servidores MCP para compartirlos entre proyectos y equipos. Y las dinámicas: automatización programada (cron) — trabajo recurrente por horario, sin humano presente; loop — iteración hacia un objetivo con criterio de corte (goal); pipeline — etapas encadenadas donde cada salida alimenta la siguiente; workflow — orquestación de varios agentes o etapas con control de flujo definido.