GitWhy

¿Qué es GitWhy?

GitWhy es una “capa de contexto” para Git que guarda y comparte el razonamiento detrás del código generado por IA, vinculado directamente a los commits que lo produjeron. El objetivo es hacer revisables los prompts, decisiones y trade-offs junto con los cambios de código, en lugar de dejar esa información solo en una ventana de chat.

Captura contexto estructurado (como el prompt original, razonamiento, decisiones y alternativas rechazadas) y vincula ese contexto a los commits. El producto muestra el razonamiento guardado en pull requests para que los revisores vean por qué se hicieron los cambios, no solo el diff.

Características clave

• Contextos de “razonamiento” estructurados: Almacena un formato fijo que incluye el prompt, razonamiento, decisiones, alternativas rechazadas, archivos y commits para mantener las salidas consistentes entre ejecuciones.
• Vinculado a commits (proveniencia nativa de git): Cada contexto guardado está ligado a los commits exactos que lo produjeron, para que la documentación permanezca anclada a la historia del código.
• Publicación en PR vía gitwhy-bot: Envía el razonamiento completo a las pull requests como comentarios de PR, haciendo disponible el contexto de revisión durante la revisión de código.
• Sincronización en la nube y compartición: Sincroniza los contextos guardados a la nube para que los equipos los compartan en toda la organización.
• Búsqueda entre contextos guardados: Permite buscar razonamientos guardados por palabra clave, dominio o tema para encontrar rápidamente decisiones previas.
• Compatible con agentes MCP: Diseñado para funcionar con cualquier agente compatible con MCP (la página menciona explícitamente Claude Code, Cursor, Windsurf y Cline).
• Interfaz de terminal para gestión: Ofrece una interfaz interactiva en terminal para navegar, buscar y gestionar contextos sin necesidad de navegador.

Cómo usar GitWhy

1. Genera código con un agente compatible con MCP y asegúrate de que el agente produzca el razonamiento que quieres capturar.
2. Guarda el contexto de razonamiento, donde GitWhy registra los elementos estructurados (prompt, razonamiento, decisiones, alternativas rechazadas, archivos y commits) y los vincula a los commits relevantes.
3. Sincroniza a la nube (para compartición en equipo) y luego abre una pull request.
4. Revisa en la PR: El bot de GitWhy publica el razonamiento guardado en la pull request para que los revisores lean las decisiones y trade-offs subyacentes.

Casos de uso

• Revisión de PR para cambios asistidos por IA: Cuando la IA genera código, los revisores pueden leer el razonamiento y decisiones almacenados en el comentario de PR en lugar de inferir la intención del diff.
• Captura de conocimiento del equipo para decisiones de diseño recurrentes: Decisiones de autenticación, base de datos y diseño de API pueden almacenarse en un árbol de contextos organizado por dominio/tema, ayudando a los equipos a reutilizar racional previos.
• Auditoría del “porqué” detrás de commits específicos: Como cada contexto está vinculado a los commits que lo produjeron, los desarrolladores pueden rastrear el origen de una decisión hasta los cambios de código exactos.
• Recuperación más rápida durante nuevo trabajo: Busca contextos guardados por palabra clave, dominio o tema desde la terminal, agente o dashboard del equipo para encontrar racional relevante rápidamente.
• Flujos de trabajo multiagente: Equipos que usan diferentes agentes compatibles con MCP pueden capturar y gestionar el razonamiento en un solo lugar sin depender de una interfaz de chat única.

Preguntas frecuentes

• ¿Qué información almacena GitWhy para cada contexto? La página describe un formato estructurado que incluye el prompt, razonamiento, decisiones, alternativas rechazadas, archivos y commits.

• ¿Cómo conecta GitWhy el razonamiento con el código? Vincula cada contexto guardado a los commits exactos que lo produjeron.

• ¿Dónde ven los revisores el razonamiento? El bot de GitWhy publica el razonamiento completo en las pull requests como comentarios de PR.

• ¿Se puede usar sin navegador? Sí. El producto incluye una interfaz de terminal interactiva para navegar, buscar y gestionar contextos.

• ¿Qué agentes están soportados? El sitio indica que funciona con cualquier agente compatible con MCP y menciona específicamente Claude Code, Cursor, Windsurf y Cline.

Alternativas

• Descripciones o comentarios simples en PR: Los equipos pueden pegar el razonamiento manualmente en el texto de la PR, pero esto no preserva automáticamente un historial estructurado y vinculado a commits de por qué se hicieron los cambios.
• Sistemas de documentación externa (wikis/bases de conocimiento): Los equipos pueden mantener documentos de decisiones por separado, pero estos no están inherentemente vinculados a commits ni se muestran automáticamente en las PR.
• Revisión de historial de logs/chat local: Leer logs de chat previos puede proporcionar contexto, pero es menos buscable y generalmente no está conectado a los commits en el historial del repositorio.
• Herramientas generales de revisión de código con anotaciones: Las herramientas que anotan diffs pueden explicar cambios, pero el texto fuente enfatiza el razonamiento estructurado vinculado a commits y la publicación en PR a través de gitwhy-bot, lo que puede no estar cubierto por herramientas de revisión genéricas.