# Setup de equipo

Para cuando varios desarrolladores comparten un proyecto Argui. Implementa los controles de
[`methodology/teams.md`](../../methodology/teams.md): la **guarda de gobernanza** y la **validación
del nombre de rama**. Es setup que se hace **una vez**, antes de trabajar en paralelo (Fase 5).

## 1. CODEOWNERS

Copia `CODEOWNERS.template` a `.github/CODEOWNERS` (o la ubicación de tu forge) y:

1. **Crea los equipos** en tu forge (`@org/arquitectura`, `@org/plataforma`, `@org/diseno`) y vincula
   a los miembros según los mecanismos de tu organización.
2. **Ajusta las rutas** a las reales de tu proyecto (dónde viven los estándares, el design system,
   los pines de versión).
3. **Activa la protección de rama** en `main`: *requerir revisión de Code Owners* + el check de la
   guarda de gobernanza (abajo) como obligatorio.

## 2. Checks de CI (esqueletos)

No se distribuyen como archivos: la sintaxis es específica de cada CI (Continuous Integration) y un YAML
ajeno envejece mal. Se documenta el **esqueleto** para que cada proyecto lo implemente en su pipeline.

**Validar el nombre de la rama** — el nombre es la clave del tablero de claim; un nombre mal formado
lo rompe. Rechazar si la rama no casa con `<tipo>/<ID>-<slug>`:

```
# tipo: feat|fix|chore|docs|refactor|test|build|ci|perf
# ID:   F<fase>.<paso>  (fases 0–4)   |   <PREFIJO>-<n>  (item del backlog, p. ej. PRJ-014)
^(feat|fix|chore|docs|refactor|test|build|ci|perf)/(F[0-9]+\.[0-9]+|[A-Z]+-[0-9]+)-[a-z0-9-]+$
```

(Opcional, más fuerte: además verificar que el `<ID>` exista en el backlog — atrapa typos como
`PRJ-041` por `PRJ-014`.)

**Gate de gobernanza declarado** — fallar el build si el PR toca una ruta gobernada sin declararse
como cambio de gobernanza. Esqueleto: *listar los archivos cambiados del PR → si alguno casa con una
ruta gobernada y el PR no lleva la etiqueta/metadato `governance` → salir con error*. Es el espejo del
gate `architectural` del ciclo (ver [`methodology/teams.md`](../../methodology/teams.md)).