🤖 Subagentes y Git

Los subagentes son instancias de Claude Code que el agente principal lanza para ejecutar tareas aisladas.

Permite escalar el trabajo sin contaminar el contexto del agente principal.

Padre-hijo; aislamiento de contexto; delegación.

La herramienta interna de Claude Code que crea subagentes con su propio prompt y contexto.

Es la interfaz principal para orquestar el trabajo en paralelo.

Task(prompt); retorno del resultado; alcance limitado.

Los subagentes pueden tener distintos niveles de permisos: lectura, escritura o background.

Elegir el tipo correcto evita conflictos y reduce riesgos.

Principio del menor privilegio; agentes especializados.

El padre envía instrucciones y contexto; el hijo devuelve un resultado textual al terminar.

Entender el flujo evita la pérdida de información entre agentes.

Prompt de entrada; respuesta estructurada; sin estado compartido.

Los worktrees de git permiten que cada subagente trabaje en archivos sin entrar en conflicto con los demás.

Sin aislamiento, los agentes paralelos se estorban entre sí.

git worktree; rama temporal; merge posterior.

Los subagentes tienen un costo adicional de contexto y uso. No todas las tareas justifican el paralelismo.

Evita gastar tokens innecesariamente en tareas simples.

Costos operativos frente a beneficios; tareas independientes; complejidad mínima.

Disparar varias herramientas Task simultáneamente para tareas independientes.

Identificar las tareas que no dependen unas de otras para ejecutarlas simultáneamente.

Usar git worktree add para crear espacios de trabajo aislados por agente.

Ejecutar tareas largas en segundo plano mientras el agente principal continúa.

Reunir los resultados de todos los subagentes y consolidarlos en un resultado final.

Estrategias para gestionar fallas parciales: retry, skip o abort.

Distribuir el trabajo entre N agentes y reunir los resultados en un único lugar.

Encadenar agentes donde el resultado de uno alimenta al siguiente.

Un agente explora el codebase, otro planifica y otro ejecuta. Separación de responsabilidades.

Agentes con prompts específicos para pruebas, docs, lint o seguridad.

Patrones de retry, fallback y circuit-breaker adaptados para agentes de IA.

Limita los tokens por subagente, usa modelos más pequeños para tareas simples y mide el ROI.

Claude analiza el diff y genera mensajes de commit según el estándar conventional commits.

Claude selecciona archivos relacionados lógicamente para commits atómicos.

Pídele a Claude que revise el diff antes de confirmar, para detectar bugs e inconsistencias.

Claude entiende el contexto de ambos lados y resuelve conflictos semánticamente.

Usar branches cortas y enfocadas que facilitan el trabajo del agente.

Proteger secretos (.env, keys) y evitar que el agente haga commit de archivos sensibles.

Claude usa gh pr create para abrir PRs con título, descripción y labels automáticos.

Usar Claude para revisar los PR de colegas o del propio agente antes del merge.

Integrar los checks de CI en el workflow para que Claude solo haga merge cuando todo esté en verde.

Claude lee los comentarios de revisión y aplica automáticamente los cambios solicitados.

Mantener un historial lineal y legible con squash merges y rebase interactivo.

PR pequeños, enfocados, bien descritos y con las pruebas aprobadas: la receta para hacer merge rápido.

Automatizaciones basadas en eventos de GitHub: push, PR, schedule.

Usar Claude Code dentro de GitHub Actions para hacer review, fix y deploy automático.

Ejecutar suites de pruebas en cada push y bloquear el merge si fallan.

Deploys automáticos después del merge: Vercel, Railway, Docker, etc.

Dependabot, CodeQL y escaneo de secretos integrados en el pipeline.

Notificaciones de fallas, health checks y rollback automático.