Contexto da base de código

Dê aos Coding Agents um contexto persistente da base de código.

Transforme o conhecimento do repositório em contexto que dura para além de um prompt. O FiboCode mantém especificações, designs, planos, análises, explicações de alterações, código, documentação e grafos ligados dentro do projeto, para que a tarefa seguinte do Agent comece com mais do que o histórico da conversa.

Os Agents precisam do contexto do projeto, não apenas de um prompt maior.

Um Coding Agent consegue inspecionar ficheiros durante uma sessão, mas o raciocínio por trás de decisões anteriores perde-se facilmente quando existe apenas na conversa. Repetir arquitetura, restrições e alterações anteriores consome tempo e obriga o Agent a reconstruir relações que a equipa já compreendeu.

A engenharia de contexto torna esse conhecimento duradouro e selecionável. O FiboCode regista a compreensão do projeto em Markdown junto ao código e liga-a por caminhos e grafos. O Agent recebe material concreto do repositório que as pessoas podem rever, melhorar e transportar para a alteração seguinte.

Veja o contexto do projeto crescer com o código.

As demonstrações mostram conhecimento ligado a circular entre vistas e a evoluir à medida que o repositório muda.

Vídeo de demonstração — registos da evolução em espiral com especificação, design, plano, diff e análises

Veja registos duradouros acumularem-se em torno de trabalho real, em vez de desaparecerem no fim de uma conversa com o Agent.

Vídeo de demonstração — percorrer código, documentação e grafos ligados

Siga as ligações que permitem a um Agent ou programador recuperar as provas por trás de uma parte do contexto do projeto.

Crie contexto que um Agent possa reutilizar.

O objetivo não é conservar todas as mensagens, mas sim os factos e decisões do projeto de que o trabalho futuro depende.

  1. Defina o limite do contexto.

    Comece pela funcionalidade, módulo, decisão ou falha que o Agent precisa de compreender. Selecione ficheiros e símbolos relevantes em vez de tratar todo o repositório como um único prompt indiferenciado.

  2. Registe conhecimento duradouro em Markdown.

    Documente especificações, designs, planos, análises e explicações de alterações num formato que permaneça legível sem a sessão de conversa original.

  3. Ligue o conhecimento ao código-fonte e às relações.

    Utilize caminhos, etiquetas e grafos para conservar a origem de uma afirmação e a sua relação com outros módulos ou documentos.

  4. Leve o contexto para a tarefa seguinte do Agent.

    Permita que o Agent CLI escolhido leia o material relevante do projeto e reveja e atualize esses registos à medida que a implementação e a compreensão evoluem.

Contexto que permanece inspecionável.

  • Registos pertencentes ao repositório.

    O contexto importante vive com o projeto em Markdown legível, sem depender da sessão de um único fornecedor ou de memória privada.

  • Ligações rastreáveis ao código-fonte.

    Os caminhos e as etiquetas mantêm as explicações ligadas ao código que descrevem e permitem às pessoas verificar as suposições iniciais de um Agent.

  • Várias vistas do contexto.

    O código fornece a verdade da implementação, a documentação explica comportamento e intenção e os grafos mostram relações que o texto, por si só, pode esconder.

  • Evolução através das alterações.

    Especificações, designs, planos, registos de diff e análises conservam o que mudou e porquê, permitindo que o trabalho posterior parta da compreensão anterior.

Caso de utilização: entregar uma funcionalidade a uma nova sessão do Agent.

Uma equipa já mapeou um subsistema, documentou uma restrição e concluiu uma alteração relacionada. Em vez de colar uma conversa antiga numa sessão nova, o programador encaminha o Agent CLI para a análise, o design e o registo de alterações relevantes, juntamente com os ficheiros de código-fonte.

O Agent começa com material do projeto já revisto. À medida que a nova alteração avança, a equipa pode aperfeiçoar o mesmo contexto e manter o repositório útil para a pessoa ou Agent seguinte, em vez de criar mais uma explicação isolada.

A engenharia de contexto não é acumulação de prompts.

Um prompt longo pode levar detalhes para um pedido, mas não se transforma automaticamente em conhecimento do projeto fácil de manter. O FiboCode separa o contexto duradouro da conversa transitória e dá-lhe ligações visíveis ao código, aos documentos e aos grafos.

O Agent continua a raciocinar e a editar através do Agent CLI escolhido. O FiboCode fornece o contexto partilhado e inspecionável em torno desse fluxo; o desenvolvimento orientado por especificações acrescenta um percurso estruturado desde um novo requisito até à execução planeada.

Perguntas sobre o contexto da base de código

O que significa aqui contexto persistente?

Significa que o conhecimento importante do projeto é registado junto ao código em documentos e ligações reutilizáveis, em vez de existir apenas numa conversa temporária com um Agent.

O FiboCode fornece um novo Coding Agent?

Não. Mantém o Agent CLI em que já confia. O FiboCode enriquece o contexto do espaço de trabalho e volta a ligar o trabalho do Agent à compreensão e revisão no editor.

Porquê utilizar Markdown para o contexto do Agent?

Markdown é fácil de ler e escrever para pessoas e Agents, funciona bem para especificações e explicações e permanece inspecionável como material do projeto.

O contexto pode incluir diagramas e relações?

Sim. Os grafos e as etiquetas complementam Markdown e código, tornam as relações navegáveis e conservam caminhos para o material subjacente do projeto.

Como deve mudar o contexto quando o código muda?

Compare os registos relevantes com a nova implementação e atualize-os quando necessário. O objetivo é uma base de conhecimento viva e rastreável, não um resumo congelado.