Alfredo Juan
Volver al taller

02Herramienta

VibeExplainer101

Para entender lo que se construyó

VibeExplainer101 organiza un proyecto en módulos, componentes y archivos. La propuesta es que quienes construyen con IA puedan investigar el resultado, siguiendo las conexiones entre una explicación y el código que la sustenta.

Formulario✓ verificado API✓ verificado Almacenamiento✓ verificado Cuentas~ inferido server/db.ts verificado en el códigoparcialmente inferido

Por qué lo hice

Empecé a construir software con IA cuando eso todavía implicaba copiar y pegar código, función por función. Hoy puedo hacer proyectos mucho más grandes, y no siempre es fácil entender todo lo que se construyó. A veces el proyecto funciona, miro esa cantidad de archivos y pienso: dibújamelo para que lo entienda. VibeExplainer101 nació de esa necesidad: tener un mapa del software, empezar por una vista simple y poder entrar en los detalles. Es una dificultad mía que también veo en otras personas que crean con IA.

Un ejemplo pequeño

“Recipe box” es una aplicación de recetas ficticia, usada como ejemplo en el proyecto. El esquema de abajo se dibujó a partir de ella para esta página; no es una captura de VibeExplainer101. Muestra la diferencia entre una parte examinada en detalle y una relación todavía parcialmente inferida.

Recipe box

RecetasFormularioVerificado
APIRecibe cambiosVerificado
AlmacenamientoRecetasVerificado
Cuentas↝ Parcialmente inferido

Una explicación que se puede examinar

El proyecto vincula las explicaciones con archivos y fragmentos de código. También distingue lo verificado de lo parcialmente inferido. Esa indicación ayuda a investigar una afirmación; por sí sola, no garantiza que la explicación sea correcta.

En desarrollo

La interfaz y el alcance del proyecto siguen evolucionando. Por ahora, esta página muestra solo el concepto.