¿Qué es IWTBI?
IWTBI (I Want To Build It) es una herramienta de análisis automático de repositorios de GitHub. A partir de una URL pública, clona el código, lo analiza mediante varios agentes de inteligencia artificial y genera un documento Markdown que describe cómo está construido el proyecto: su arquitectura, tecnologías, base de datos, API, frontend, lógica de negocio y configuración de despliegue.
El objetivo es educativo e informativo: proporcionar un punto de partida para entender cómo funciona un proyecto antes de clonarlo, contribuir a él o replicarlo. IWTBI no juzga la calidad del código ni certifica nada sobre el repositorio analizado.
Cómo funciona el análisis
Cuando introduces la URL de un repositorio, IWTBI lleva a cabo los siguientes pasos de forma automática y en un entorno completamente aislado:
- Clona el repositorio en un directorio temporal y efímero, que se elimina automáticamente al terminar.
- Lee y filtra los archivos de código más representativos, ignorando binarios y dependencias de terceros.
- Lanza siete agentes de IA en paralelo, cada uno especializado en un área: pila tecnológica, arquitectura, base de datos, API, frontend, lógica de negocio y DevOps.
- Un sintetizador unifica las secciones en un documento final coherente y bien estructurado.
- El resultado se guarda en caché asociado al SHA del commit analizado. Análisis sucesivos del mismo estado del repositorio no incurren en costes repetidos.
Todo el proceso se ejecuta en el servidor. El usuario solo recibe el documento final; nunca tiene acceso directo al directorio temporal ni a los artefactos intermedios.
Qué hace IWTBI y qué no hace
Lo que hace
- Analiza repositorios públicos de GitHub.
- Genera documentación técnica sobre el código existente.
- Guarda el resultado en la Biblioteca para futuras consultas.
- Compara el SHA del análisis guardado con el HEAD actual para alertar de cambios.
Lo que no hace
- No ejecuta el código del repositorio.
- No modifica el repositorio ni crea commits ni ramas.
- No accede a repositorios privados.
- No garantiza exactitud ni completitud; la IA puede cometer errores.
- No es una auditoría de seguridad ni un análisis de vulnerabilidades.
Riesgos y limitaciones
Los análisis generados por IA tienen limitaciones inherentes. El modelo puede malinterpretar patrones de código, omitir secciones relevantes o describir funcionalidades de forma imprecisa. El documento generado es una aproximación orientativa, no una especificación técnica verificada. Trátalo como un punto de partida para tu propia investigación, no como una fuente definitiva.
IWTBI no garantiza la disponibilidad del servicio, la corrección de los análisis ni la permanencia de los resultados en la Biblioteca. Los análisis pueden ser eliminados o actualizados sin previo aviso.
Si decides replicar o adaptar el código de un repositorio analizado, eres responsable de verificar que cumples con la licencia del proyecto original. IWTBI no asume ninguna responsabilidad por el uso que hagas del documento generado ni por las decisiones que tomes a partir de él.
Privacidad y datos
IWTBI procesa únicamente repositorios públicos de GitHub. No recopila datos personales salvo los que el usuario proporciona de forma voluntaria, como la dirección de correo electrónico para recibir una notificación cuando el análisis esté listo.
Los correos electrónicos se utilizan exclusivamente para enviar la notificación solicitada. No se ceden a terceros, no se almacenan más allá del tiempo necesario para completar el envío y no se emplean con ningún fin de marketing o seguimiento.
El análisis generado —el documento Markdown— se almacena en nuestra base de datos junto con la URL del repositorio, el nombre completo (owner/repo) y el SHA del commit en el momento del análisis. Esta información es pública y puede consultarse en la Biblioteca por cualquier visitante.
Limitación de responsabilidad
IWTBI se proporciona «tal cual» (as-is), sin garantías de ningún tipo, expresas o implícitas, incluyendo pero sin limitarse a las garantías de comerciabilidad, idoneidad para un propósito particular o no infracción. El uso del servicio es bajo tu propia responsabilidad.
En ningún caso los autores o mantenedores del proyecto serán responsables de daños directos, indirectos, incidentales, especiales, ejemplares o consecuentes —incluyendo pérdida de datos, pérdida de beneficios o interrupción del negocio— derivados del uso o la imposibilidad de uso del servicio, incluso si se les ha advertido de la posibilidad de dichos daños.
Código abierto
IWTBI es un proyecto de código abierto. Su código fuente está disponible públicamente y puedes revisarlo, auditarlo, modificarlo y redistribuirlo conforme a los términos de su licencia. La transparencia del código es una garantía adicional de que el servicio hace exactamente lo que dice que hace.
Si encuentras un error, una imprecisión en esta política o quieres proponer una mejora, abre un issue o un pull request en el repositorio. Las contribuciones son bienvenidas.