No nos quedamos por ideas. Nos quedamos por estrategia.
Este repositorio es el manual de operaciones de nuestro laboratorio. Define cómo planteamos, ejecutamos y publicamos nuestros proyectos de software de investigación en una era donde la IA generativa cambió las reglas del juego.
En 2026, escribir código dejó de ser el cuello de botella. Una persona con herramientas de IA puede generar en horas lo que antes tomaba meses. En este nuevo contexto, lo que distingue a un proyecto valioso ya no es la cantidad de código, sino:
- La calidad del problema que resuelve
- El diseño que hay detrás
- La forma en que se desarrolla y se sostiene en el tiempo
- La evidencia de que otros lo usan y lo necesitan
Las revistas científicas también lo entendieron. JOSS (Journal of Open Source Software), una de las principales revistas de software de investigación, reformuló sus criterios en enero de 2026 para reconocer precisamente eso: el aporte humano por encima del volumen de código. Este manual recoge esa filosofía y la traduce en una forma de trabajar.
A todas las personas del laboratorio: estudiantes de pregrado y posgrado, investigadores, colaboradores externos. Si vas a iniciar un proyecto, contribuir a uno existente, o aspiras a publicar un paper de software, este es tu punto de partida.
Léelo en orden la primera vez. Después funciona como referencia: cuando estés en una fase específica, vuelves al documento correspondiente.
📜 Los 10 Mandamientos del Lab — los hábitos no negociables del día a día, en una sola página. Si solo lees un documento, que sea este.
- Filosofía — El "por qué" detrás de cómo trabajamos.
- Ciclo de proyecto — Las fases por las que pasa todo proyecto, desde la idea hasta la publicación.
- Desarrollo abierto — Prácticas concretas para que un proyecto sea publicable desde el día cero.
- Política de uso de IA — Cómo usamos IA generativa y cómo lo declaramos.
- Publicación en JOSS — Guía paso a paso para postular.
- Checklists — Listas de verificación por fase.
- Visibilidad y crecimiento — Cómo construimos visibilidad para nuestros proyectos: estrellas, comunidad, lanzamientos.
En plantilla-proyecto/ encuentras una estructura base que puedes copiar para iniciar un repositorio nuevo. Incluye los archivos mínimos que JOSS exige y los que nosotros recomendamos.
Transparencia desde el inicio. Los repositorios nacen públicos. No desarrollamos en privado para luego "abrir" el código. Si vas a postular a JOSS, las nuevas reglas exigen al menos seis meses de historial público antes de la postulación, y esto solo se construye trabajando abiertamente desde el principio.
Iteración real, no sprints disfrazados. Preferimos commits pequeños y distribuidos en el tiempo, antes que volcados masivos de código. JOSS hace análisis automático de la distribución de commits, pero más allá de eso, la iteración real es la que produce mejor software.
El humano decide, la IA asiste. La IA puede generar código, sugerir refactores, ayudar con documentación. Pero el planteamiento del problema, las decisiones de diseño y la responsabilidad ética son humanas. Y siempre se declaran.
Evidencia antes que intención. Un proyecto vale por lo que se usa, no por lo que aspira a ser usado. Buscamos casos reales de uso desde temprano: nosotros mismos primero, colaboradores después, comunidad eventualmente.
Sostenibilidad como diseño. Tests, documentación, gobernanza, ruta de contribución. No son adornos: son lo que permite que el software sobreviva al estudiante que se va.
Este es un documento vivo. Si encuentras algo que falta, está mal o se puede mejorar, abre un issue o envía un pull request. Las contribuciones al manual cuentan como contribuciones al lab.
Este manual se distribuye bajo licencia CC BY 4.0. Adáptalo a tu propio laboratorio si te resulta útil; solo pedimos atribución.