Organiza un workshop

Vincula una carpeta como tu workspace de orch, registra proyectos y carpetas compartidas, y manten los limites de git claros.

Objetivo#

Configurar un workshop: una carpeta raiz que contiene varios proyectos (cada uno su propio repo git) mas carpetas compartidas por lenguaje que cualquier proyecto puede leer. Dejar lista la estructura que siembra orch init sin romper los limites de git.

Pasos#

Crea (o entra con cd) la carpeta que sera tu workshop raiz, y vinculala:
```
orch setup
```
Esto escribe orch.yaml y .orch/ en la carpeta actual, pregunta por nombres opcionales de carpetas de proyecto/compartidas, y agrega la carpeta de orch.exe al PATH del usuario.
Siembra la estructura ordenada y la doctrina:
```
orch init
```
orch init pregunta el locale de docs, las carpetas compartidas, los nombres de proyecto/app, y si quieres instalar los hooks de orch guard. Siembra un CLAUDE.md delgado, DEV_PRACTICES.md, GATES.md, y un TRACKER.md por proyecto, y luego hace git init en cada proyecto y carpeta compartida — nunca en la raiz del workshop. Agrega --recommend para usar por defecto shared/<lang>/ + projects/<app>/, o --dry-run para previsualizar sin escribir.
Registra una carpeta de proyecto existente (si no la creaste durante orch init):
```
orch project add products/saint
```
Las rutas se resuelven primero desde cwd, luego desde la raiz del workspace. --name define un id corto (por defecto: el nombre de la carpeta).
Registra una carpeta compartida por lenguaje:
```
orch shared add shared/go --lang go
```
--lang toma por defecto workspace.primary_languages, o el unico bucket shared.* si solo hay uno. Esto tambien siembra e indexa los simbolos de esa carpeta de inmediato.

Limites de git#

La raiz del workshop no es un repo git. orch init nunca corre git init ahi.
Cada carpeta de proyecto es su propio repo (orch project add no lo crea — registra una carpeta existente, o corre git init tu mismo primero).
Las carpetas compartidas tambien son sus propios repos, uno por bucket de lenguaje.
.orch/ (token de dispositivo, db local, salida de herramientas externalizada) se agrega automaticamente al .gitignore de la raiz del workshop por orch setup/orch init — es estado local en tiempo de ejecucion, no algo para commitear.

Verificar#

orch project list
orch shared list

project list muestra cada ruta registrada y, si otra sesion Chair interactiva y viva ya tiene ese proyecto, un sufijo (chair: name, workers: N). shared list imprime una linea <lang>\t<path> por carpeta registrada.

Deshacer#

orch project remove <path-or-name>
orch shared remove <path>

Ambos solo desregistran la entrada de orch.yaml — ninguno borra la carpeta ni su historial de git.

Relacionado#

configure-agents.md — una vez que el workshop existe, dile a orch que CLIs de agentes lanzar.
worktrees.md — como las sesiones despachadas obtienen su propio checkout aislado por proyecto.