Os agentes leem seu código e os arquivos de instrução do seu repositório. Contexto reúne esses arquivos de memória com as notas do projeto, o contexto gerado e as referências.
Para entender o motivo de esses elementos estarem aqui, leia Contexto do projeto em Conceitos. Esta página aborda como gerenciá-lo.
Arquivos de memória do repositório
Abra Configurações → Conhecimento → Contexto e procure em Fontes do repositório. O Coroid lê esses arquivos do repositório conectado:
AGENTS.mdna raiz do repositório: instruções gerais para agentesCLAUDE.mdna raiz do repositório: instruções para o ClaudeGEMINI.mdna raiz do repositório: instruções para o Gemini.cursor/rules: o arquivo de regras do Cursor suportado
Esses arquivos são frequentemente chamados de arquivos de memória. Seus conteúdos habilitados são incluídos no contexto do projeto dos agentes antes do início do trabalho. Os nomes não os restringem a um modelo específico: as fontes habilitadas são combinadas para os agentes do Coroid.
Os arquivos existentes aparecem com um Editar botão, uma contagem estimada de tokens e uma switch que controla se os agentes receberão ou não esses arquivos. As fontes ficam habilitadas a menos que você as desative explicitamente. Se vários arquivos se repetirem ou contradizerem uns aos outros, mantenha habilitadas apenas as fontes que deseja que os agentes sigam e desative as demais.
Criar indica que o arquivo foi confirmado como ausente no checkout do repositório do Coroid. Se a leitura falhar, a página oferece Tentar novamente; uma falha de acesso não significa que o arquivo esteja ausente. Verifique se o arquivo está commitado no branch do repositório conectado. Para a execução de tarefas, o agente lê o checkout da tarefa, portanto alterações nos arquivos de instrução nesse branch afetam a tarefa.
Os arquivos de memória habilitados podem importar Markdown do repositório com @path, por exemplo
@AGENTS.md em CLAUDE.md ou @docs/conventions.md. Os caminhos são resolvidos de forma relativa ao
arquivo que contém a referência. O Coroid segue importações aninhadas, interrompe ciclos
e inclui cada arquivo e cada corpo de instrução idêntico apenas uma vez. Importações dentro de exemplos de código e endereços de e-mail são ignoradas. Referências fora do
repositório não são carregadas, e as importações não podem contornar uma fonte do repositório explicitamente desabilitada.
Apenas as fontes raiz listadas são detectadas automaticamente. AGENTS.md e
arquivos .cursor/rules/*.mdc individuais podem ser incluídos por meio de uma @ importação; o escopo do diretório deles não é inferido automaticamente.
Contextos de aplicativo
Em Contextos de aplicativo, mantenha instruções e referências armazenadas no Coroid. Notas manuais e o contexto do projeto gerado podem ser habilitados ou desabilitados independentemente dos arquivos do repositório. Use essas entradas para informações que pertencem fora do Git.
Adicionar contexto
Escolha Adicionar contexto e adicione uma entrada. Cada uma possui um título e corpo, podendo ser editada ou removida posteriormente.
Boas entradas são curtas, específicas e duráveis. Decisões de arquitetura, convenções de estilo, contratos do API, limites de propriedade e proibições explícitas se encaixam aqui. A narrativa de integração e qualquer coisa já óbvia no repositório não devem ser incluídas.
Mantenha as entradas separadas e nomeadas
Uma entrada por tópico, com título que indique seu conteúdo. "Convenções de tratamento de erros" e "Módulos congelados" são recuperáveis; uma única entrada chamada "Notas" contendo ambos não é.
Isso é importante porque o contexto é carregado seletivamente conforme o trabalho em questão — veja Habilidades progressivas. Entradas bem separadas permitem que a entrada certa seja carregada para a tarefa correta.
Referências
Além de entradas escritas, você pode anexar referências — links e documentos que apontam para materiais armazenados em outros locais. Use essas referências quando a cópia oficial estiver em uma wiki ou ferramenta de design e você não quiser que uma segunda cópia fique desatualizada.
Contexto por tarefa
O contexto do projeto se aplica a tudo o que está nele. Para materiais relacionados a uma única atividade — um ticket, um relatório de cliente, um documento de design — anexe-os diretamente àquela tarefa. Uma nota específica de tarefa incluída no contexto do projeto acaba virando ruído em todas as tarefas futuras.
Mantendo a informação atualizada
Contexto desatualizado é pior do que a ausência de contexto, pois os agentes o tratam como autoritativo. Quando uma convenção mudar, atualize a entrada na mesma alteração que modifica o código.
Revisando o conteúdo existente
Leia seu contexto ocasionalmente como se fosse um novo usuário. As entradas vão se acumulando, e aquelas criadas durante uma migração concluída há um ano agora podem levar a interpretações equivocadas.