Comprensión del código base
Comprende más rápido un código base desconocido.
Recorre código, documentación Markdown, grafos de relaciones e historial del proyecto desde un mismo espacio de trabajo del editor. FiboCode mantiene las explicaciones cerca del código fuente que describen, para convertir búsquedas aisladas en una ruta de exploración conectada.
Un código base es mucho más que los archivos que puedes abrir.
Un repositorio nuevo rara vez se explica en el orden que necesitas. Los nombres solo cuentan una parte, el comportamiento importante cruza los límites de los módulos y el motivo de una decisión puede estar fuera del archivo actual. Leer archivos uno tras otro muestra detalles de implementación, pero puede seguir ocultando el sistema completo.
FiboCode conecta código editable, Markdown legible y grafos navegables. Puedes partir de una selección de código relevante, leer o crear una explicación y seguir relaciones etiquetadas hasta el siguiente archivo, documento o grafo. El código sigue siendo la fuente de verdad y el conocimiento de apoyo permanece lo bastante cerca para poder verificarlo.
Observa cómo la comprensión avanza entre vistas conectadas.
Empieza con un análisis de todo el código base y después comprende un archivo mediante su documentación y sus grafos de relaciones antes de preguntar a AI por el código seleccionado.
Un análisis completo da a los archivos y directorios desconocidos una estructura legible desde la que continuar la investigación.
Recorre el código, la documentación y los grafos de un archivo y continúa desde ese conocimiento guardado con una consulta específica a AI.
Pasa de una pregunta a un contexto verificable.
El flujo permanece anclado en el repositorio y deja una ruta legible para la siguiente persona.
Empieza por el código que originó la pregunta.
Abre el archivo relevante o selecciona la implementación que necesitas comprender. Así, cada explicación parte de un contexto concreto de código fuente y no de un resumen abstracto.
Lee o registra la explicación en Markdown.
Describe el comportamiento, la intención, los límites y las preguntas abiertas en un formato que tanto desarrolladores como Coding Agents puedan leer y mejorar.
Sigue las relaciones mediante grafos y etiquetas.
Navega desde la explicación hasta módulos, decisiones o diagramas relacionados. Las etiquetas mantienen la conexión entre código, documentación y grafos sin comprimirlo todo en una sola vista.
Contrasta el modelo con el código fuente editable.
Vuelve al código referenciado cada vez que necesites comprobar una explicación. Actualiza el conocimiento junto a la implementación para que la siguiente exploración comience con pruebas actuales.
Un espacio conectado para investigar código.
El código sigue siendo la fuente de verdad.
El material de apoyo apunta a la implementación que describe, lo que facilita comprobar una explicación frente al comportamiento real.
Markdown hace legible la intención.
Los análisis, las decisiones y las explicaciones permanecen como conocimiento sencillo del proyecto que personas y Agents pueden leer y escribir.
Los grafos muestran las relaciones.
Las vistas conectadas hacen visibles y navegables las relaciones entre módulos y documentos cuando una lista lineal de archivos no basta.
El historial conserva cómo cambió la comprensión.
Las especificaciones, los diseños, las explicaciones de cambios y los análisis crean un relato trazable que puede crecer con el código base.
Caso de uso: incorporarte a un servicio que no construiste.
Imagina que heredas un servicio con una ruta de petición desconocida. Empieza por el controlador, registra lo que hace y utiliza etiquetas y grafos conectados para encontrar la lógica de dominio y la dependencia posterior. Cada paso sigue ligado a un archivo o documento que puedes inspeccionar.
El resultado conserva su utilidad después del primer recorrido. Otra persona del equipo puede volver a la misma explicación, contrastarla con el código fuente y ampliarla cuando cambie el servicio, sin repetir desde cero la investigación original.
Más duradero que un resumen puntual del código.
Un resumen generado puede ayudar, pero una respuesta aislada pronto pierde sus pruebas y su lugar en el sistema. FiboCode trata la comprensión como material conectado del proyecto: código, documentación, grafos e historial siguen siendo vistas distintas con rutas entre ellas.
Esta página ayuda a las personas a investigar un código base. Si lo siguiente que necesitas es dar a un Coding Agent contexto duradero para trabajos futuros, continúa con Contexto del código base.
Preguntas sobre la comprensión del código base
¿FiboCode sustituye la lectura del código fuente?
No. El código sigue siendo la fuente de verdad. FiboCode conecta explicaciones y relaciones con el código fuente para que puedas verificar lo que afirma el material de apoyo.
¿Puedo utilizar documentación Markdown existente?
Sí. Markdown es la superficie común para explicaciones, especificaciones, diseños, planes, análisis y registros de cambios, de modo que el conocimiento del repositorio siga siendo legible para personas y Agents.
¿Cómo ayudan los grafos en un repositorio desconocido?
Los grafos hacen visibles y navegables las relaciones. Complementan al código fuente y al texto cuando el comportamiento cruza archivos o cuando un límite del sistema es difícil de ver de forma lineal.
¿Solo resulta útil durante la incorporación?
No. También ayuda a investigar código heredado, analizar impactos, explorar la arquitectura y revisar por qué evolucionó una parte del sistema.
¿Puede un Coding Agent utilizar el mismo conocimiento?
Sí. Los registros Markdown y el contexto conectado del proyecto son legibles tanto para Agents como para personas. Contexto del código base explica cómo ese conocimiento apoya trabajos posteriores del Agent.