Compreensão da base de código
Compreenda mais depressa uma base de código desconhecida.
Percorra código, documentação Markdown, grafos de relações e o histórico do projeto num único espaço de trabalho do editor. O FiboCode mantém as explicações junto do código-fonte que descrevem, transformando pesquisas isoladas num percurso de exploração ligado.
Uma base de código é mais do que os ficheiros que pode abrir.
Um novo repositório raramente se explica pela ordem de que precisa. Os nomes revelam apenas parte da história, os comportamentos importantes atravessam módulos e o motivo de uma decisão pode estar fora do ficheiro atual. Ler ficheiros em sequência mostra detalhes de implementação, mas pode continuar a esconder o sistema mais amplo.
O FiboCode liga código editável, Markdown legível e grafos navegáveis. Pode começar por uma seleção relevante de código-fonte, ler ou criar uma explicação e seguir relações identificadas até ao ficheiro, documento ou grafo seguinte. O código continua a ser a fonte da verdade e o conhecimento de apoio permanece suficientemente próximo para ser verificado.
Veja a compreensão percorrer vistas ligadas.
Comece por uma análise de toda a base de código e compreenda depois um ficheiro através da documentação e dos grafos de relações existentes, antes de perguntar a AI sobre o código selecionado.
Uma análise global dá aos ficheiros e diretórios desconhecidos uma estrutura legível para orientar a investigação seguinte.
Percorra o código, a documentação e os grafos em torno de um ficheiro e prossiga a partir desse conhecimento guardado com uma pergunta específica a AI.
Passe de uma pergunta para um contexto verificável.
O fluxo permanece ancorado no repositório e deixa um percurso legível para a pessoa seguinte.
Comece pelo código que originou a pergunta.
Abra o ficheiro relevante ou selecione a implementação que precisa de compreender. Cada explicação parte assim de um contexto concreto de código-fonte, e não de um resumo abstrato.
Leia ou registe a explicação em Markdown.
Descreva comportamento, intenção, limites e questões em aberto num formato que programadores e Coding Agents possam ler e aperfeiçoar.
Siga as relações através de grafos e etiquetas.
Navegue da explicação para módulos, decisões ou diagramas relacionados. As etiquetas mantêm a ligação entre código, documentação e grafos sem reduzir tudo a uma única vista.
Confirme o modelo no código-fonte editável.
Regresse ao código referenciado sempre que uma explicação precise de ser verificada. Atualize o conhecimento junto da implementação para que a exploração seguinte comece com provas atuais.
Um espaço de trabalho ligado para investigar código.
O código continua a ser a fonte da verdade.
O material de apoio remete para a implementação que descreve, facilitando a confirmação de uma explicação face ao comportamento real.
Markdown torna a intenção legível.
Análises, decisões e explicações permanecem conhecimento simples do projeto que pessoas e Agents podem ler e escrever.
Os grafos revelam relações.
As vistas ligadas tornam visíveis e navegáveis as relações entre módulos e documentos quando uma lista linear de ficheiros não é suficiente.
O histórico conserva a evolução da compreensão.
Especificações, designs, explicações de alterações e análises criam um relato rastreável que pode crescer com a base de código.
Caso de utilização: entrar num serviço que não desenvolveu.
Imagine que recebe um serviço com um percurso de pedidos desconhecido. Comece pelo handler, registe o que faz e utilize etiquetas e grafos ligados para encontrar a lógica de domínio e a dependência seguinte. Cada passo permanece associado a um ficheiro ou documento que pode inspecionar.
O resultado continua útil depois da primeira visita. Outra pessoa da equipa pode retomar a mesma explicação, compará-la com o código-fonte e alargá-la quando o serviço mudar, sem repetir do zero a investigação inicial.
Mais duradouro do que um resumo pontual do código.
Um resumo gerado pode ajudar, mas uma resposta isolada perde depressa as provas e o lugar no sistema. O FiboCode trata a compreensão como material ligado do projeto: código, documentação, grafos e histórico mantêm-se como vistas distintas com caminhos entre si.
Esta página ajuda pessoas a investigar uma base de código. Se o passo seguinte for dar a um Coding Agent contexto duradouro para trabalho futuro, prossiga para Contexto da base de código.
Perguntas sobre a compreensão da base de código
O FiboCode substitui a leitura do código-fonte?
Não. O código continua a ser a fonte da verdade. O FiboCode liga explicações e relações ao código-fonte para que possa verificar o que afirma o material de apoio.
Posso utilizar documentação Markdown existente?
Sim. Markdown é a superfície comum para explicações, especificações, designs, planos, análises e registos de alterações, mantendo o conhecimento do repositório legível para pessoas e Agents.
Como ajudam os grafos num repositório desconhecido?
Os grafos tornam as relações visíveis e navegáveis. Complementam o código-fonte e o texto quando o comportamento atravessa ficheiros ou quando um limite do sistema é difícil de ver linearmente.
Isto só é útil durante a integração?
Não. Também apoia a investigação de código legado, a análise de impacto, a exploração da arquitetura e a revisão posterior dos motivos pelos quais uma parte do sistema evoluiu.
Um Coding Agent pode utilizar o mesmo conhecimento?
Sim. Os registos Markdown e o contexto ligado do projeto são legíveis por Agents e por pessoas. Contexto da base de código explica como esse conhecimento apoia o trabalho seguinte do Agent.