El sistema CI/CD de Wiedii es centralizado y gestionado por el equipo de Infraestructura. Los repositorios de desarrollo no contienen configuraciones de pipeline — todo el CI/CD vive en un repo dedicado de infra y se conecta a cada proyecto desde GitLab.
Audiencia: Este documento es referencia técnica para el equipo de Infraestructura que gestiona el repo central de CI/CD (>).
Regla general
Qué es y de dónde viene
Todo repositorio debe tener .gitignore, .gitattributes y .editorconfig configurados para compatibilidad entre plataformas (Windows, Linux, macOS).
Todo repositorio Wiedii debe tener un renovate.json en su raíz. Sin este archivo el runner de Renovate no procesa el repositorio y sus dependencias nunca se actualizarán automáticamente.
⚠️ Verificar versiones antes de usar — la versión de git-flow-next documentada aquí puede estar desactualizada. Consultar brew info git-flow-next o git-flow.sh para la versión más reciente. Ver politicas-core.
Todos los commits deben seguir el formato Conventional Commits con emoji obligatorio:
⚠️ Verificar versiones antes de usar — los números de versión de imágenes base en esta nota pueden estar desactualizados. Usar docker pull y revisar las notas de lanzamiento oficiales antes de fijar versiones. Ver politicas-core.
Todo repositorio Wiedii debe tener un CONTRIBUTING.md en su raíz. Este archivo es el contrato de contribución del proyecto: explica a cualquier desarrollador (o agente IA) cómo preparar el entorno, crear ramas, escribir commits y abrir un Merge Request.
Todo proyecto debe integrar al menos un escáner en CI/CD.
Todo repositorio debe tener lefthook.yaml con hooks activos. Los hooks se instalan automáticamente via [hooks].postinstall en mise.toml al ejecutar mise install --yes, con detección de CI para no ejecutarse en pipelines.
⚠️ Verificar versiones antes de usar — los números de versión de herramientas en esta nota pueden estar desactualizados. Usar mise ls-remote | tail -5 para consultar las versiones disponibles. Ver politicas-core.
⚠️ Verificar versiones antes de usar — las versiones de paquetes (ESLint, ruff, PHPStan, etc.) pueden estar desactualizadas. Usar bun info version para npm o mise ls-remote para herramientas. Ver politicas-core.
Usar Nx cuando el proyecto tiene múltiples paquetes que comparten código o se despliegan de forma independiente.
Configurar en GitLab → Settings → Repository → Protected branches, tanto para main como para develop:
CLAUDE.md / AGENTS.md por repositorio
- Formato: MAJOR.MINOR.PATCH — sin prefijo v, nunca
Estas reglas aplican a todo repositorio Wiedii, sin excepción, tanto para el equipo humano como para agentes de desarrollo.