Cómo se instala
La guarda de gobernanza y la validación del nombre de rama: setup de una sola vez, antes de trabajar en paralelo.
# 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)).