Date: 2026-09-10

​
Gestão de contexto e sessões

Nesta última lição, vais aprender a manter sessões extensas úteis: limitar o âmbito dos pedidos, inspecionar o contexto, separar perguntas laterais e retomar trabalho quando ainda for relevante.

​
Porque é que o contexto importa

O modelo ativo só pode raciocinar sobre a informação que recebe no momento. Na Nova, esse contexto pode incluir política de sistema, regras da organização, instruções do agente, orientação do projeto, memória guardada, interações da conversa, definições de ferramentas e resultados recentes das ferramentas. O contexto não é o mesmo que o repositório. Os ficheiros permanecem no disco até a Nova os pesquisar ou ler. Uma base de código grande não consome automaticamente toda a janela de contexto.

​
Fontes de contexto

A Nova reúne informação relevante a partir de:
  • Instruções internas de sistema e de fluxo de trabalho.
  • Regras e políticas da organização, quando configuradas.
  • O prompt e o perfil de capacidades do agente ativo.
  • Instruções de projeto em NOVA.md, NOVA.local.md e .compass/rules/*.md.
  • Tópicos explícitos de memória do projeto e partilhada.
  • A conversa atual e os seus resumos.
  • Resultados de ferramentas de ficheiros, shell, Git, MCP e outras.
  • Referências a ficheiros e anexos fornecidos por ti.
Como estas camadas podem entrar em conflito, as políticas de segurança e organização de maior autoridade têm precedência sobre instruções de projeto ou do utilizador.

​
Inspecionar a utilização de contexto

Usa:
O comando apresenta os principais consumidores do contexto ativo, incluindo a conversa, definições de ferramentas, competências, comandos com barra e outro material injetado. É útil quando as respostas se tornam menos focadas ou uma tarefa extensa se aproxima dos limites do modelo. Usa /usage para informação de utilização. O consumo de contexto e a utilização da conta estão relacionados, mas não são equivalentes.

​
Manter os prompts delimitados

Sessões eficientes dão à Nova um objetivo limitado e alvos de evidência concretos. Prefere:
Evita combinar pedidos não relacionados de implementação, arquitetura, implementação, documentação e investigação numa só interação, salvo se forem realmente um único fluxo de trabalho. Quando mudares substancialmente de tópico, inicia uma sessão separada ou usa uma pergunta lateral, em vez de transportares histórico irrelevante.

​
Perguntas laterais

Usa /ask para uma pergunta que não deva poluir a conversa principal:
A pergunta lateral recebe contexto útil, mas a respetiva troca não é adicionada à conversa principal. Isto é útil durante uma implementação quando uma explicação curta não deve alterar a narrativa da tarefa.

​
Compactar sessões extensas

Usa:
A compactação substitui pormenores mais antigos da conversa por um resumo limitado para que a sessão possa continuar com mais contexto disponível. A Nova também permite uma pré-visualização:
Um resumo compactado deve preservar decisões, restrições, trabalho concluído, bloqueios por resolver, caminhos importantes e a ação seguinte. Não consegue preservar todas as nuances descartadas; regista regras duradouras críticas nas instruções do projeto, em vez de dependeres apenas do histórico da conversa.

​
Limpar, repor e reverter

Estas operações têm âmbitos diferentes:
  • /rollback last remove a última interação de utilizador/agente do contexto da conversa; os efeitos secundários existentes mantêm-se.
  • /clear cria uma sessão nova depois de limpar o histórico da conversa, estatísticas de tokens, histórico de operações e resumos compactados. Pede confirmação antes de limpar conversas com mais de 20 mensagens, salvo se for fornecido --force.
  • /reset está registado como um alias de /clear; não expõe uma operação de reposição mais abrangente dentro da sessão.
  • nova reset é um comando de topo separado e destrutivo para eliminar dados Compass globais ou do projeto. Revê cuidadosamente o âmbito e o pedido de confirmação.
  • /compact preserva um resumo e é normalmente a opção mais segura quando o objetivo é apenas libertar contexto.
Não uses um comando de contexto como substituto para reverter ficheiros, commits de Git, mensagens enviadas, escritas em bases de dados ou ações externas.

​
Sessões guardadas

A Nova armazena o histórico das sessões de projeto em estado gerido pela Compass. No terminal, usa:
Isto lista as sessões arquivadas do projeto atual. Fornece um ID de sessão para a retomar:
A pesquisa de sessões é sensível ao projeto. Executa o comando a partir da mesma raiz de projeto para que a Nova resolva o histórico esperado.

​
Instruções versus memória

Usa o mecanismo de persistência adequado:
  • NOVA.md e regras — convenções e instruções estáveis da equipa que devem orientar trabalho futuro.
  • Memória — preferências explícitas, decisões de projeto, prazos e referências que valha a pena recordar.
  • Histórico de sessão — o registo detalhado de uma conversa.
  • Resumo de compactação — continuidade para a sessão extensa atual.
Não guardes segredos, credenciais em bruto, conteúdos de documentos privados, registos transitórios nem factos que possam ser derivados do repositório em memória duradoura.

​
Estratégia prática

  1. Inicia cada sessão com um objetivo coerente.
  2. Deixa a Nova pesquisar código em vez de colares diretórios inteiros.
  3. Usa referências @file para entradas críticas.
  4. Analisa /context quando a conversa se tornar longa.
  5. Usa /ask para perguntas isoladas.
  6. Pré-visualiza e executa /compact antes de a pressão sobre o contexto se tornar grave.
  7. Move convenções estáveis para NOVA.md ou para um ficheiro de regras focado.
  8. Retoma sessões guardadas apenas quando as respetivas decisões ainda se aplicarem ao estado atual do repositório.

​
Recapitulação

  • O contexto contém apenas a informação que a Nova recebeu ou recuperou para a sessão.
  • Pedidos focados, perguntas laterais e compactação mantêm o trabalho compreensível.
  • Escolhe o mecanismo de persistência de acordo com o tipo de informação que queres conservar.

​
Prática segura

Numa sessão de teste, pede uma explicação breve por meio de uma pergunta lateral e depois analisa o contexto:
Confirma que a pergunta lateral não desviou a tarefa principal. Usa /compact --preview antes de compactares uma conversa com decisões importantes. Anterior: Explorar, planear, programar, verificar e fazer commit · Voltar ao curso