Espacios de trabajo (worktrees)

Próximamente

Por qué cada tarea vive en su propia copia del código y cómo se crea, se usa y se borra un espacio de trabajo.

En el Taller, cada tarea tiene su propio espacio de trabajo. Por dentro es un worktree de git: una copia del repositorio en tu disco, con su propia rama. En vez de cambiar de rama y guardar cambios a medias en una sola carpeta, cada tarea tiene la suya. Por eso varios agentes pueden trabajar a la vez sin pisarse los archivos.

Es la misma regla que sigue la plataforma: cada tarea del equipo de agentes es visible y tiene su espacio y su rama propios.

Cómo funciona

Cada proyecto tiene un punto de partida (normalmente la rama principal).
Cada espacio de trabajo nace de una rama o de un commit que tú eliges.
Cada espacio tiene su rama, sus archivos y sus terminales con agentes.
Borrar un espacio quita la carpeta y la rama, siempre con confirmación.

El ciclo de una tarea

Crear: nombre de la tarea, desde dónde empezar y, si quieres, el enlace a la incidencia o al cambio relacionado.
Trabajar: terminales con agentes, editor y navegador, todo dentro de ese espacio.
Revisar: el diff contra el punto de partida, con comentarios por línea.
Entregar: guardar, subir y abrir la revisión, sin salir del Taller.
Archivar o borrar: un clic quita el espacio y su rama.

Desde dónde empezar

Al crear un espacio puedes partir de:

La rama principal del proyecto (lo más común).
Otra rama local, para apilar trabajo sobre un cambio que aún está en revisión.
Un commit concreto.
Una rama remota, que el Taller descarga por ti.

Archivos que git no guarda

Un espacio nuevo es una copia limpia: no trae las dependencias instaladas, las cachés ni los archivos de secretos locales que git ignora. Para no rehacerlos cada vez puedes:

Compartir carpetas pesadas (como node_modules) entre espacios, por enlace.
Copiar archivos concretos (como .env.local) a cada espacio nuevo con un archivo .worktreeinclude en la raíz del proyecto:

# .worktreeinclude
.env.local
.vscode/settings.json

Nombre de la rama

Por omisión, el Taller deriva el nombre de la rama del nombre que le das a la tarea. Si necesitas uno exacto (por ejemplo feat/pagos), escríbelo en las opciones avanzadas al crear el espacio.

Dónde corre

Un espacio puede vivir en tu computador o en otra máquina. Mira servidores remotos y SSH.