Saltar para o conteúdo principal

Um Passeio de 5 Minutos pelo Deep Code

Já abordámos como instalar o Deep Code em menos de três minutos. Agora vamos ver como funciona na prática. Este guia percorre uma tarefa real do início ao fim e mostra-lhe como ler tudo o que o Deep Code apresenta no ecrã.

Muitas ferramentas de IA conseguem gerar uma página inicial vistosa a partir de uma única linha de instrução — um truque de circo elegante, mas não é assim que o software real é construído. O Deep Code funciona de forma diferente: mantém-se fixo na sua tarefa do início ao fim, como um líder técnico experiente que nunca perde o fio à meada.

O Que Vamos Construir​

Eis o plano para esta sessão:

  1. Analisar um repositório de código existente
  2. Criar a estrutura de um site de documentação Docusaurus
  3. Escrever documentação de utilização para a Aplicação Desktop Deep Code
  4. Garantir que a documentação é fácil de manter no futuro

Passo 1: Inicie e Dê uma Tarefa​

Abra o Deep Code no seu ambiente de trabalho. O Deep Code reúne o Claude Code TUI com um iniciador automático que trata de todas as dependências CLI e da configuração do ambiente. Não é necessária qualquer configuração manual. Pode utilizá-lo imediatamente após a transferência.

Após iniciar o Deep Code, introduza as suas instruções na área de interação.

Assim que o espaço de trabalho carregar, introduza as suas instruções. Eis o que lhe dei:

  • Criar um ramo Git — para podermos reverter se algo correr mal.
  • Instalar o Docusaurus — o framework de documentação que estamos a utilizar.
  • Analisar e escrever — ler o repositório de código e gerar a estrutura e o conteúdo da documentação.

Passo 2: Aprenda a Linguagem Visual do Deep Code​

Assim que prima Enter, as coisas começam a acontecer. O segredo para trabalhar com o Deep Code é saber o que os pontos e ícones realmente significam:

O segredo para trabalhar com o Deep Code é compreender os indicadores de pontos e ícones no ecrã
  • Ponto branco — feedback ou raciocínio. Está a dizer-lhe o que acabou de fazer, ou a explicar o seu processo de pensamento.
  • Ponto verde — uma chamada de ferramenta bem-sucedida. Verá isto sempre que executar um comando com sucesso.
  • Asterisco vermelho-alaranjado — está a pensar. Se permanecer visível durante muito tempo, é geralmente um problema de rede.
  • Dica — as saídas grandes são contraídas por defeito. Prima Ctrl + O para expandir ou contrair.

Passo 3: Erros e Autocorreção​

Um ponto vermelho significa que ocorreu um erro. O Deep Code analisa imediatamente o histórico e corrige o problema automaticamente.

Verá um ponto vermelho em algum momento. Não entre em pânico — não significa que a tarefa falhou. A IA também comete erros. Nesta demonstração, introduziu um false extra num comando de criação de diretório, pelo que o passo seguinte não conseguiu encontrar o caminho esperado.

A diferença é que o Deep Code observa a sua própria saída. Quando algo não corresponde ao esperado, retrocede pelo histórico e corrige o problema sozinho — não precisa de o detetar.

Ao modificar ficheiros, utiliza diffs com cores claras

Quando edita ficheiros, obtém um diff limpo com cores: verde para adições, vermelho para remoções. Cada alteração é visível numa olhada. Se uma compilação CSS exceder o tempo limite durante uma construção, diagnostica o erro e tenta novamente automaticamente.

Conclusão​

Eis o que o Deep Code entregou no final da sessão: um site de documentação totalmente estruturado, com navegação lateral configurada e conteúdo de páginas preparado e pronto a usar.

O Deep Code não é um gerador de código que despeja saída e vai embora. É mais como uma ferramenta que mantém a consciência da sua tarefa durante todo o processo. Verifica o próprio trabalho, deteta os próprios erros e corrige o rumo sem que tenha de intervir.

Pense no Deep Code como um capataz atento numa obra: os pontos brancos são ele a anunciar o que está a acontecer, os pontos verdes significam que tem as ferramentas à mão e a trabalhar, e quando coloca um prego no sítio errado (ponto vermelho), retira-o de imediato e corrige — não precisa de ficar a vigiá-lo por cima do ombro.

Agora que viu o Deep Code em ação, há um conceito que sustenta tudo o que faz: contexto. Se notou que as respostas abrandam durante uma sessão longa, ou perguntou-se por que razão começar uma conversa fresca por vezes funciona melhor, tudo se resume à forma como os LLMs (Modelos de IA) gerem o contexto. A seguir: uma análise aprofundada do que é realmente o contexto e como o gerir eficazmente.