Saltar al contenido principal

Contribución

Reglas del proyecto​

El archivo CLAUDE.md en la raíz del repo contiene las reglas obligatorias. Aplican a todos los contribuidores (humanos e IAs).

Reglas de oro​

  1. Nunca editores de JSON crudo en la UI — siempre editores estructurados
  2. Nunca IDs en pantalla — siempre nombres legibles (IDs en tooltips)
  3. Nunca duplicar lógica — extraer helper antes de copiar

Documentación obligatoria​

Todo cambio debe actualizar la documentación en el mismo commit:

  • internal/system-description.md — entidades, endpoints, permisos
  • internal/design.md — decisiones de arquitectura
  • internal/checkpoint.md — estado actual
  • internal/tests-backend.md — inventario de tests backend
  • internal/tests-frontend.md — inventario de tests frontend

Idioma​

  • Código interno en inglés (entidades, variables, endpoints)
  • Mensajes al usuario en español (UI labels, errores, notificaciones)

Workflow de desarrollo​

  1. Crear branch desde main
  2. Implementar con tests
  3. Verificar CI verde (ci-success)
  4. Crear PR
  5. Mergear solo si CI está verde

Política de CI​

  • Prohibido mergear a main sin CI verde
  • Prohibido git push --force origin main
  • Todo pasa por PR