AgentFlow
Fiabilidad

Aislamiento por worktrees

Un worktree Git por tarea bajo .agentflow/worktrees.

Aislamiento por worktrees

Implementación application/internal/worktree que entra cuando workflow.Service.DevFeature necesita zona aislada para dev.

Comportamiento

La aislamiento es predecible:

  1. Para cada tarea AgentFlow crea worktree debajo worktrees.base_path
  2. Rama con worktrees.branch_prefix + id feature/tarea
  3. Subprocesos agente ejecutan con WorkingDir en ese worktree
  4. agentflow clean borra conforme cleanup_policy
worktrees:
  base_path: .agentflow/worktrees
  branch_prefix: agentflow
  cleanup_policy: keep_failed   # keep_failed | always | ...

Diagrama

Las tareas concurrentes se bifurcan desde raíz oficial sin workspace sucio accidental compartido:

flowchart TB
  R[Repo root] --> W1[worktree task-001]
  R --> W2[worktree task-002]
  W1 --> A1[cursor-agent in W1]
  W2 --> A2[cursor-agent in W2]

Dry-run

--dry-run omite/simula crear worktrees — integración puede depender cuando CI debe evitar ramas fugaces innecesarias.

Policies

Combina policies.max_files_changed_per_task con revisión manual previa fusión ; limita alcance físico pero no vigilancia estratégica.

Relacionado

Investigación local

Grep acotado y exploración del sistema de ficheros antes de llamadas a agentes cloud.

Resumen de arquitectura

Módulos Go bajo application/internal y pipeline de ejecución.

On this page

Aislamiento por worktreesComportamientoDiagramaDry-runPoliciesRelacionado