¿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 en el servidor:
- 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 especialistas en lotes de hasta tres llamadas: pila tecnológica, arquitectura, base de datos, API, frontend, lógica de negocio y DevOps.
- Margaret Hamilton cruza las siete secciones, conserva su contenido y añade el orden de construcción, los criterios globales y las incógnitas.
- 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 repositorios públicos de GitHub. También trata la dirección IP y datos técnicos básicos de la solicitud para proteger el servicio, limitar abusos y diagnosticar errores. La dirección de correo electrónico solo se solicita cuando el usuario pide una notificación.
Los correos se envían mediante Resend, proveedor que procesa la dirección para entregar el mensaje. Si eliges recibir avisos futuros, conservamos la suscripción hasta que la canceles; si no, el correo se utiliza para la notificación concreta. Los enlaces de baja caducan por seguridad.
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.