Date: 2026-09-10

​
O que é a Nova?

Começa o curso por compreenderes o que a Nova pode fazer num projeto e quais as salvaguardas que orientam o seu trabalho.

​
Visão geral

A Nova é o agente de IA baseado em terminal da Compass para trabalho de engenharia de software e produtividade. Em vez de funcionar como uma janela de conversa isolada, opera a partir de um diretório de trabalho onde pode analisar um projeto, interpretar o código envolvente, usar ferramentas, fazer alterações aprovadas e verificar resultados. A Nova foi concebida para fluxos de trabalho de engenharia reais: repositórios desconhecidos, sessões de longa duração, trabalho sem commit, implementação com várias etapas e tarefas que exigem evidências em vez de respostas apenas plausíveis.

​
O que a Nova pode fazer

Uma sessão com a Nova pode combinar conversa com ações concretas:
  • Pesquisar nomes de ficheiros e conteúdos do projeto.
  • Ler ficheiros e analisar a estrutura do projeto.
  • Analisar dependências e convenções existentes.
  • Editar ou criar ficheiros com controlos de aprovação.
  • Executar testes, linters, verificações de tipos, builds e comandos de curta duração.
  • Analisar o estado, os diffs e o histórico do Git.
  • Preparar commits quando pedidos explicitamente.
  • Criar planos de implementação para alterações complexas.
  • Delegar trabalho delimitado a agentes especializados.
  • Invocar competências reutilizáveis.
  • Ligar a sistemas externos através de servidores MCP.
  • Executar hooks do ciclo de vida em torno de prompts, ferramentas, agentes e sessões.
A distinção importante é que a Nova pode analisar e alterar o mesmo espaço de trabalho onde o programador está a trabalhar. Assim, as suas respostas podem basear-se em evidências do repositório, em vez de suposições.

​
Como encarar o agente

Um modelo mental útil é um ciclo:
  1. Compreender o pedido — identificar o resultado pretendido e as restrições relevantes.
  2. Recolher evidências — pesquisar e ler apenas o suficiente do projeto para agir em segurança.
  3. Escolher um fluxo de trabalho — responder diretamente, editar de imediato, criar um plano ou delegar trabalho especializado.
  4. Agir com ferramentas — modificar ficheiros, executar verificações ou usar serviços ligados.
  5. Verificar — comparar o resultado com testes, diffs, diagnósticos ou comportamento observável.
  6. Comunicar — indicar o que mudou, o que passou e qualquer bloqueio ou risco real.
A Nova não se limita a gerar comandos de shell para copiares. Sujeita à política de aprovação ativa, pode executar ferramentas diretamente e aguardar pelos respetivos resultados antes de continuar.

​
Execução controlada

A utilização de ferramentas é regida por um sistema de aprovação, e não por acesso sem restrições. A Nova implementa quatro modos de aprovação:
  • Manual — pede autorização antes de operações que exigem consentimento.
  • Auto — aprova automaticamente operações elegíveis de baixo risco dentro dos limiares configurados.
  • Strict — exige aprovação mesmo para operações de menor risco.
  • Smart — usa a complexidade e o risco da tarefa para permitir trabalho direto adequado, mantendo barreiras de aprovação noutros casos.
As ações destrutivas ou visíveis externamente continuam a ser sensíveis. A Nova também fornece um modo /unleash explícito para operação sem barreiras, mas ativá-lo exige confirmação e pode ser recusado pela política da organização. Deve ser tratado como um modo excecional, não como o fluxo de trabalho predefinido.

​
Conhecimento do projeto

A Nova constrói o contexto do projeto a partir de várias fontes:
  • O diretório de trabalho atual e a estrutura de repositório detetada.
  • Configuração de projeto e global.
  • Ficheiros de instruções NOVA.md e regras modulares .compass/rules/*.md.
  • Competências de projeto ou pessoais e comandos com barra.
  • Ferramentas, agentes, servidores MCP e hooks disponíveis.
  • O histórico da sessão atual e a memória guardada relevante para o projeto.
Isto permite às equipas manter convenções de trabalho duradouras junto do código, em vez de as repetirem em todos os prompts.

​
Nova versus um chatbot genérico

Um chatbot genérico pode explicar código colado numa conversa. A Nova pode analisar a base de código real, seguir definições e locais de chamada, preservar alterações locais, fazer edições e executar os próprios comandos de verificação do repositório. Esta superfície de ação mais ampla é mais útil, mas também torna instruções precisas e controlos de aprovação mais importantes.

​
Utilização eficaz

Bons pedidos descrevem um resultado observável e restrições importantes. Por exemplo:
Este prompt indica à Nova que deve investigar antes de editar, preferir uma correção da causa principal e comprovar o resultado.

​
O que aprendeste

  • A Nova trabalha a partir do diretório do teu projeto e baseia o trabalho em evidências do repositório.
  • O seu fluxo combina análise, ação controlada, verificação e comunicação clara.
  • A política de aprovação mantém-se ativa para operações sensíveis.

​
Exercício prático seguro

Num projeto que não seja de produção, pede à Nova que identifique os pontos de entrada e os testes principais. Exige referências a ficheiros e indica que não deve alterar nada.

Visão geral do curso

Volta à visão geral da Nova 101.

Seguinte: Como funciona a Nova

Continua para a lição 2.