Pular para o conteúdo
← Voltar para o Skalablog

Artigo publicado

Como usar Claude Code começando pelo simples

Engenharia de SoftwareClaude CodeClaude CodeAnthropicSupabase

Uma conversa simples com o Claude Code já resolve a maior parte das tarefas do dia a dia. O argumento do Augusto Galego, em vídeo de setembro de 2026, é que muita gente copia fluxos mirabolantes de loop engineering e graph engineering sem ter problema real que justifique esse custo em tokens e manutenção.

Por que começar simples no Claude Code

Começar simples no Claude Code, a ferramenta de codificação agêntica da Anthropic que roda no terminal, é suficiente para a maioria das tarefas. Você digita o comando, descreve o que quer e conversa. Ferramentas desse tipo ficaram tão boas na descoberta de capacidades que montar um castelo de configurações antes do primeiro commit costuma ser desperdício.

O argumento é antigo na computação: complexidade prematura nunca ajudou ninguém. Quando você importa dezenas de skills populares, conecta vários servidores MCP e arma subagents para uma tarefa perfeitamente comum, o resultado é mais gasto de tokens sem ganho proporcional de qualidade no código.

Isso não significa ignorar os recursos avançados. Significa que cada camada de complexidade precisa corresponder a uma necessidade real do seu fluxo de trabalho e da sua empresa. O resto é queimação de token e dificuldade extra de manutenção.

O espectro entre simplicidade e complexidade

Todo desenvolvedor está em algum ponto de um espectro que vai de 'abrir o terminal e conversar' até pipelines de agentes em loop. O problema, segundo o vídeo, é que muita gente tenta pular direto para o extremo complexo porque parece ser o que todo mundo está fazendo.

Fluxos complexos são mais caros em tokens, mais difíceis de manter e só fazem sentido em casos específicos. A evolução natural, então, é gradual: você começa conversando, nota padrões que o agente não segue, e resolve isso com um arquivo de instruções do projeto. Só depois disso valem skills, MCPs e automações.

A tabela abaixo resume quando cada camada costuma valer a pena. Ela descreve um caminho de adoção sugerido pelo autor do vídeo, não um limite técnico das ferramentas:

Níveis de adoção: quando cada camada entra

Cada nível resolve um problema diferente. Passe para o seguinte apenas quando o anterior não atender mais ao seu caso:

NívelO que adicionaQuando faz sentido
Conversa diretaNada, só o terminalTarefas pontuais e projetos pequenos
Claude.md ou AGENTS.mdPadrões e regras do projetoO agente ignora convenções do time
Skills própriasInstruções repetidas viram comandosPrompts de code review, spec ou endpoint se repetem
MCPsIntegração com Jira, Slack, SentryVocê copia e cola tickets o tempo todo
Subagents e loopsParalelismo e monitoramentoVolume alto de tarefas ou vigilância contínua

Repare que o salto acontece por demanda. Nenhum nível é mágico, e pular etapas costuma gerar configuração que você não sabe manter.

Do prompt repetido à skill própria

Com o tempo, você percebe pedaços de prompt que se repetem: as instruções de code review, as de criar um endpoint novo, as de escrever uma spec ou migrar um banco de dados. É aí que entra uma skill. Você empacota aquela instrução recorrente em algo reutilizável, ajustado ao seu jeito de trabalhar.

A melhor skill é a que você mesmo cria. Skills populares existem aos montes, algumas são boas e já foram testadas em vídeos anteriores, mas nenhuma conhece a organização da Supabase de código nem os processos da sua empresa. Uma skill genérica que luta contra a sua estrutura vira ruído, não ganho.

O mesmo vale para o arquivo de instruções: um AGENTS.md ou o arquivo de memória do projeto deve registrar o que você teve de corrigir manualmente mais de duas vezes. Se nunca precisou corrigir nada, ainda não há motivo para configurar.

MCPs: integre ferramentas quando a cópia e colar cansar

Em algum momento você está usando o Claude Code para buscar tickets no Jira, resumir discussões do Slack ou checar erros no Sentry, plataforma de monitoramento de erros. Copiar e colar isso manualmente funciona, mas incomoda. É o sinal de que vale avaliar um servidor MCP.

O Model Context Protocol, padrão aberto criado pela Anthropic, permite que agentes conversem com ferramentas externas por uma interface comum. Existem conectores para GitHub, Jira, Slack e muitos outros serviços.

Aqui vale a mesma regra do espectro: adote o MCP que elimina fricção real do seu dia. Se você abre três tickets por semana, o conector não paga a própria configuração. Se você troca de ferramenta vinte vezes por dia, ele se paga na primeira manhã.

Quando loops e subagents fazem sentido

O extremo complexo do espectro tem casos de uso legítimos, mas específicos. Um agente em loop monitorando erros no Sentry ou no Slack pode ser interessante para um time que recebe alto volume de incidentes. Um agente acompanhando pull requests para sugerir melhorias faz sentido quando o fluxo de revisão é intenso.

Subagents ajudam a dar vazão a tarefas simples e paralelizáveis. O ponto do vídeo é outro: essa camada vem com o tempo, depois que você entende o que cada peça faz e para que serve. E não existe necessidade de aprender loop engineering ou graph engineering se nenhum problema seu pede isso.

A métrica prática é simples: a complexidade que você usa deve ser a mesma que o seu fluxo de trabalho e a sua empresa comportam. Conforme a necessidade aparece e seu conhecimento aumenta, você adiciona ferramental para gerar mais valor. Não o contrário.

Do vídeo ao artigo escrito

A lição central deste conteúdo é que conhecimento útil não precisa de aparato mirabolante para valer a pena: um fluxo simples, bem entendido, entrega mais que um pipeline complexo copiado de outro contexto. O mesmo acontece com o que você já gravou em vídeo. Uma explicação de seis minutos, como a que originou este artigo, carrega uma tese, evidências e um caminho prático que merecem existir também em texto, onde buscadores e leitores encontram.

Se você tem aulas, opiniões ou lições espalhadas em vídeos, como fazem criadores como o Gustavo Dev Doido, que produz conteúdo formativo e mantém formações como o Crazystack Typescript e o Bootcamp do Dev Doido, transformar essas gravações em artigos é a forma mais direta de ampliar o alcance. Complexidade mínima, valor máximo.

Com o Skala Blog, o fluxo é curto: você cola o link do vídeo do YouTube, a ferramenta transcreve o áudio e gera um artigo estruturado, pronto para sua revisão e publicação.

— Teste agora: visite skalablog.com, cole a URL de um dos seus vídeos e receba um rascunho de artigo em minutos.

Perguntas frequentes sobre fluxos de trabalho com Claude Code

  • Preciso instalar skills desde o primeiro dia no Claude Code?

Não. Comece conversando direto no terminal. Adicione skills quando perceber que os mesmos pedaços de prompt se repetem em várias tarefas e você já conhece os padrões do seu projeto.

  • O que é um MCP e por que usar?

MCP é o Model Context Protocol, padrão aberto para conectar agentes a ferramentas externas como Jira, Slack e GitHub. Ele elimina a cópia manual de tickets e contextos, mas só compensa quando essa troca é frequente no seu dia.

  • Skills populares servem para qualquer projeto?

Não. Elas podem inspirar, mas a skill mais eficaz é a que você cria para se adequar à Supabase de código, ao seu time e ao seu processo. Uma skill genérica tende a brigar com as convenções do projeto.

  • Loops e graph engineering são exagero?

Para a maioria dos casos, sim. Automatizações de monitoramento em loop e grafos de agentes fazem sentido com alto volume de eventos ou tarefas paralelas. Sem essa demanda, é custo de tokens e manutenção sem ganho de qualidade.

  • As mesmas ideias valem para outras ferramentas de agente?

Sim. O vídeo cita que ferramentas como Codex da OpenAI e Kimi funcionam de maneira muito similar: começar simples, registrar padrões e evoluir a configuração conforme a necessidade é um caminho independente de fornecedor.

Source video