Date: 2026-09-10

A tua primeira sessão com a Nova

Nesta lição, vais iniciar uma sessão no diretório correto, pedir uma análise fundamentada e rever o resultado antes de aceitares alterações.

Começar no diretório correto

Abre um terminal no projeto que queres que a Nova compreenda:

Set-Location C:\path\to\your-project
nova

A Nova usa o diretório de início para determinar a raiz do projeto, a configuração relevante, os ficheiros de instruções, as sessões guardadas e o âmbito do repositório. Começar um nível acima pode expor ficheiros não relacionados; começar demasiado abaixo pode ocultar contexto do projeto.

Começar por um pedido de orientação

Num repositório desconhecido, pede à Nova que analise antes de editar:

Explica o objetivo deste projeto, os seus principais pontos de entrada e a forma como os testes estão organizados. Indica os ficheiros que sustentam a resposta. Não alteres nada.

Um bom primeiro prompt define:

Resultado — o que queres saber ou alterar.
Âmbito — o subsistema, diretório, ficheiro ou comportamento envolvido.
Restrições — compatibilidade, segurança, estilo ou ficheiros que têm de permanecer intocados.
Evidência — os testes, comandos, diffs ou comportamento de UI que comprovam o sucesso.

Referir ficheiros concretos

A Nova reconhece referências a ficheiros com @ nos prompts. Usa-as quando um ficheiro específico for central:

Explica o fluxo de validação no formulário de checkout e identifica os respetivos chamadores. Não edites ficheiros.

As referências a ficheiros reduzem a ambiguidade, mas não substituem a análise do código envolvente. Para trabalho de implementação, a Nova deve continuar a ler importações, tipos, testes e locais de chamada relacionados antes de editar.

Pedir explicação antes de agir quando necessário

Se ainda estás a decidir o que deve mudar, separa a descoberta da implementação:

Segue o motivo pelo qual sessões expiradas ainda podem aceder à página de faturação. Indica a causa principal e duas correções viáveis com as respetivas vantagens e desvantagens. Ainda não edites.

Depois, escolhe uma abordagem:

Aplica a correção no middleware. Mantém a API pública inalterada e executa os testes direcionados e a verificação de tipos.

Para uma tarefa simples e bem delimitada, basta um prompt direto:

Corrige a apresentação do estado nulo que está a falhar no cartão de perfil, preserva o estilo visual existente e executa os testes do componente e a verificação de tipos.

Acompanhar ferramentas e aprovações

A Nova mostra atividade de ferramentas enquanto pesquisa, lê, edita ou executa comandos. Consoante o modo de aprovação ativo e o risco da operação, pode pedir autorização antes de continuar. Usa o comando de aprovação para analisar ou alterar o comportamento:

/approve
/approve smart
/approve manual
/approve strict

Não aproves uma operação apenas porque foi sugerida pelo agente. Lê o caminho de destino, o comando e a descrição do risco, sobretudo em eliminações, publicação através de Git, alterações a bases de dados ou ações externas.

Comandos de sessão úteis

O conjunto exato de comandos está disponível em /help. Alguns comandos comuns incluem:

/context — analisa o que está a usar a janela de contexto.
/compact — resume uma conversa extensa para recuperar contexto.
/model — analisa ou muda o modelo ativo.
/usage — analisa informação de utilização.
/agents — lista, analisa ou muda agentes especializados.
/ask — faz uma pergunta lateral sem a adicionar à conversa principal.
/commit — prepara um commit a partir de alterações preparadas.
/rollback last — remove a última interação da conversa do contexto; os efeitos secundários mantêm-se.
/exit — sai da sessão.

Trata /rollback last com cuidado: altera o contexto da conversa, não ficheiros, comandos já executados, commits, e-mails ou outros efeitos secundários.

Rever o resultado

Quando a Nova terminar, confirma o essencial:

Que ficheiros mudaram?
O diff corresponde ao âmbito pedido?
Que verificações foram efetivamente executadas?
Houve verificações ignoradas ou bloqueadas?
Existem suposições que ainda precisem de validação no ambiente real?

Pede uma resposta concisa se necessário:

Resume a causa principal, os ficheiros alterados e os resultados de verificação. Menciona apenas os riscos por resolver.

Terminar ou retomar mais tarde

A Nova guarda sessões de projeto. Usa nova session fora da UI interativa para listar sessões arquivadas de um projeto ou retomar uma pelo ID. Numa sessão ativa longa, /compact preserva um resumo ao mesmo tempo que reduz a pressão sobre o contexto.

Recapitulação

Inicia a Nova na raiz do projeto certo.
Define o resultado, o âmbito, as restrições e a evidência no teu pedido.
Revê o diff e as verificações executadas antes de considerares a tarefa concluída.

Prática segura

Executa apenas um pedido de orientação num repositório de teste:

Identifica os principais pontos de entrada e os testes existentes. Indica os ficheiros que sustentam a resposta. Não alteres nada.

Lê cada ficheiro citado e confirma se a conclusão corresponde à evidência. Anterior: Instalar e configurar a Nova · Seguinte: Explorar, planear, programar, verificar e fazer commit

​A tua primeira sessão com a Nova

​Começar no diretório correto

​Começar por um pedido de orientação

​Referir ficheiros concretos

​Pedir explicação antes de agir quando necessário

​Acompanhar ferramentas e aprovações

​Comandos de sessão úteis

​Rever o resultado

​Terminar ou retomar mais tarde

​Recapitulação

​Prática segura