Desarrollo asistido por IA: Guía de contribución de ownCloud

Nuestra postura

ownCloud da la bienvenida a las contribuciones creadas con ayuda de herramientas de IA.

Creemos que las grandes ideas no deben verse limitadas por la experiencia programando. Si tienes una visión para mejorar ownCloud —una nueva extensión web, un flujo de trabajo más eficiente, una corrección que puedes describir claramente— y la IA te ayuda a convertir esa visión en código funcional, queremos tu contribución.

Hemos publicado una guía detallada sobre desarrollo asistido por IA para extensiones web de oCIS en owncloud.dev. Esa guía recorre todo el flujo de trabajo: desde conversaciones de arquitectura con un asistente de IA, pasando por la investigación, la creación de la estructura, la implementación, hasta el pulido y la contribución. Te animamos a seguirla.

Lo que esperamos

Las contribuciones asistidas por IA deben cumplir con el mismo estándar de calidad que cualquier otra contribución. El proceso de revisión no se fija en cómo se escribió el código, sino en que funcione, esté probado, documentado y sea mantenible.

Cada pull request asistido por IA debe cumplir estos requisitos:

Divulgación. Indica en la descripción de tu PR que usaste herramientas de IA en el desarrollo. Nombra la herramienta (por ejemplo, Claude Code, GitHub Copilot, Cursor). Esto no es un estigma —es transparencia. Lo registramos para entender nuestro ecosistema de colaboradores y mejorar nuestros procesos de revisión.
Comprensión. Debes entender lo que hace el código. Si un revisor pregunta “¿por qué esta función gestiona el error de esta forma?” y tu respuesta es “lo escribió la IA”, eso no es suficiente. Tú eres el autor. La IA es tu herramienta. Si no puedes explicar el código, no está listo para enviarse.
Pruebas. El código generado por IA debe estar probado. Pruebas unitarias para la lógica. Pruebas exploratorias manuales para la interfaz. La guía de desarrollo con IA cubre cómo usar DevTools del navegador, archivos HAR y la consola para depurar de forma eficaz. Los PR sin cobertura de pruebas adecuada serán devueltos.
Documentación. Documenta lo que hace el código, cómo se usa y cualquier configuración necesaria. Si el código introduce nuevas APIs, variables de entorno o puntos de extensión, deben estar documentados.
Calidad de código. El código generado por IA suele acumular lógica redundante, variables sin usar, estilos duplicados y condicionales demasiado complejos. Antes de enviar, haz una pasada de limpieza. Pídele a tu herramienta de IA que refactorice, elimine código muerto y simplifique. Nuestra canalización de CI incluye linting —los PR que no pasen los chequeos de lint serán devueltos.
Cumplimiento de licencias. Asegúrate de que tu herramienta de IA no haya introducido código copiado de licencias incompatibles. Eres responsable del origen de cada línea en tu PR.

Lo que no hacemos

No rechazamos contribuciones por haber sido asistidas por IA. No exigimos que los colaboradores sean “desarrolladores senior”. No ponemos barreras según cómo escribiste el código.

Tampoco aceptamos contribuciones si la persona colaboradora no puede participar en el proceso de revisión. Si un responsable solicita cambios y no puedes hacerlos —ya sea porque no entiendes el código o porque ya no sigues con el PR—, este puede cerrarse. Ese es el mismo estándar que aplicamos a todas las contribuciones.

Guía para responsables y revisores

Las contribuciones asistidas por IA pueden requerir más esfuerzo de revisión. El código puede ser sintácticamente correcto pero estructuralmente mejorable. Los patrones pueden ser poco familiares o inconsistentes con las convenciones del proyecto.

Las personas revisoras deben:

Aplicar los mismos estándares de revisión que para cualquier contribución. Ni más bajo, ni más alto.
Dar retroalimentación específica. “Esto no sigue nuestros patrones” es menos útil que “En este módulo usamos composición en vez de herencia —mira ExampleComponent.vue para ver el patrón”.
Ser pacientes con quienes están aprendiendo. Una persona que en su primer PR necesita tres rondas de revisión puede convertirse en responsable a largo plazo. Ese es el objetivo.
Señalar si el código generado por IA parece incluir material copiado de otros proyectos o frameworks con licencias incompatibles.

IA en nuestro propio desarrollo

Los equipos internos de ingeniería de ownCloud también usan herramientas de IA. Nos aplicamos los mismos estándares: divulgación en los mensajes de commit cuando corresponde, comprensión total del código generado y responsabilidad humana en cada fusión.

Creemos que el desarrollo asistido por IA, hecho de manera responsable, reduce barreras para contribuir sin bajar la calidad. Ese es el objetivo.

Preguntas frecuentes

Sí, ownCloud acepta contribuciones creadas con la ayuda de herramientas de IA. Consideran que las buenas ideas no deberían verse limitadas por la experiencia en programación y animan a los colaboradores a usar IA para convertir sus ideas en código funcional. Sin embargo, existen directrices y requisitos al respecto.

Las pull requests asistidas por IA deben cumplir varios requisitos: indicar el uso de herramientas de IA en la descripción de la PR, que el colaborador comprenda completamente el código, realizar pruebas adecuadas (unitarias y manuales), documentación apropiada, alta calidad del código y cumplimiento de licencias para evitar código copiado de fuentes incompatibles.

No, ownCloud no rechaza contribuciones únicamente por haber sido asistidas por IA. Aplican los mismos estándares a todas las contribuciones y no ponen barreras según cómo se haya escrito el código.

ownCloud exige a las contribuciones asistidas por IA los mismos estándares de calidad que a cualquier otra. Los revisores aplican criterios consistentes, ofrecen comentarios específicos, mantienen la paciencia con quienes están aprendiendo y señalan posibles problemas de licencias si detectan material copiado.