Wiedii — Política de CONTRIBUTING.md
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.
Por qué es obligatorio
Sin CONTRIBUTING.md, cada desarrollador que se incorpora a un proyecto tiene que inferir las convenciones o preguntar. Con él, el onboarding al proyecto es autocontenido. Los agentes IA también lo leen como contexto de trabajo cuando no tienen un CLAUDE.md más específico.
Idioma
CONTRIBUTING.md se escribe en inglés. Es un archivo técnico de nivel de repositorio, al igual que README.md y CHANGELOG.md. Sigue la política de documentación bilingüe de Wiedii — si el proyecto tiene audiencia interna hispanohablante, puede acompañarse de un CONTRIBUTING.es.md.
Contenido mínimo obligatorio
| Sección | Contenido |
|---|---|
| Prerequisites | Homebrew, mise, git-flow-next, glab |
| Setup | mise run setup como único comando de bootstrap |
| Branch model | Git Flow, naming feature/TK<ticket>-<slug>, base en develop |
| Making commits | bun commit (czg wizard), Conventional Commits, primer commit chore: initial commit |
| Opening a Merge Request | Push + glab, plantilla, no auto-merge, rebase antes de merge |
| Code quality | Resumen de hooks de lefthook activos |
| Dependency updates | Renovate gestiona las versiones — no actualizar manualmente |
| Definition of Done | Checklist de requisitos mínimos para considerar completo un MR |
Plantilla
Usar la plantilla del vault como base: tpl-contributing.
Sustituir:
PROJECT_NAME→ nombre del proyecto (kebab-case)<namespace>→ namespace de GitLab (wildcat,wildcat/frontend, etc.)- Ajustar la sección de hooks según el stack del proyecto
Qué NO debe incluir
- Credenciales, tokens ni secretos de ningún tipo
- Instrucciones específicas de máquina (rutas absolutas del dev local)
- Dependencias de herramientas no instaladas vía Homebrew o mise
- Procesos que contradigan politicas-core
Integración con otros archivos del repositorio
| Archivo | Relación con CONTRIBUTING.md |
|---|---|
README.md | Incluye un enlace a CONTRIBUTING.md en la sección de desarrollo |
CLAUDE.md / AGENTS.md | Referencia CONTRIBUTING.md para contexto adicional del agente |
.gitlab/merge_request_templates/default.md | Complementa el proceso de MR descrito en CONTRIBUTING.md |
Referencias
- repo-setup — checklist completo de nuevo repositorio
- git-flow — política de ramas
- commits — política de mensajes de commit
- lefthook — política de git hooks
- renovate — política de actualizaciones de dependencias