cerebro-vip INEMA.CLUB
início › INEMA.DEV Desenvolvimento

Notas e resumo detalhado do vídeo "Full Tutorial: Build an App with…

INEMA.DEV Desenvolvimento · 2025-07-27 · ~11 min · ver no Telegram ↗

INEMA

No vídeo “Full Tutorial: Build an App with Multiple AI Agents (Claude Code)”, foram mostrados diversos arquivos de configuração usados no fluxo com o Claude Code, principalmente focados em estrutura de projeto e comandos reutilizáveis.

Aqui está a lista dos principais arquivos de configuração citados e explicados:

1. cloud.md (ou outros .md de comandos)⌗

Função:

  • São arquivos Markdown usados como comandos reutilizáveis no Claude Code.
  • Guardam instruções (prompts) estruturadas que podem ser chamadas com /slash commands.

Exemplo de pastas onde ficam:

/cloud/commands/issues.md /cloud/commands/review.md /cloud/commands/plan.md

Para que servem:

  • /issues.md: gera issues a partir de tarefas.
  • /review.md: revisão de PR com múltiplas perspectivas.
  • /proofread.md: revisão de estilo de texto.
  • /fix_critical.md: verificação crítica (ex: segurança, dados sensíveis).

⚠️ Esses arquivos podem ser locais por projeto ou globais (no sistema).

2. Arquivos plan.md e derivados⌗

Função:

  • Armazenam o plano de execução criado pelo Claude antes de codar.
  • Servem como PRD (Product Requirements Document).
  • Claude pode transformar esse conteúdo em issues ou passar para subagentes.

Exemplo de conteúdo interno:

```# Feature: Email Summarization

Objetivo⌗

Ler e-mails, resumir conteúdo e apresentar via UI.

Tarefas (to-dos)⌗

  • Criar modelos para armazenar e-mails
  • Conectar com Gmail MCP
  • Desenvolver UI para exibição```

3. .cloud/ (pasta oculta do Claude Code)⌗

Função:

  • Armazena metadados internos e histórico de sessões Claude.
  • Serve como repositório das interações e configurações do projeto.

Conteúdo comum dessa pasta:

.cloud/ ├── history.json ├── project_config.json ├── cache/ ├── commands/

Usos práticos:

  • Claude armazena aqui os to-dos, histórico de execução, e contextos anteriores.
  • Também pode conter configuração de autorizações e permissões.

4. package.json (caso haja dependências JS/TS)⌗

Função:

  • Caso o projeto inclua scripts com Node.js (ex: API helpers), este arquivo gerencia as dependências e comandos.

5. Configurações Git (.git, branches e worktrees)⌗

Função:

  • Controle de versão e separação dos agentes por feature.
  • Usado junto com comandos:

git worktree add ./feature-a feature/a

6. Alias e Funções no Terminal (.bashrc, .zshrc, .aliases)⌗

Hack usado no vídeo:

  • cc: atalho para cloud --dangerously-skip-permissions
  • wt: função para criar worktree automaticamente

Conclusão⌗

Arquivos principais mostrados:

Arquivo/Pasta Função
cloud.md ou *.md Comandos personalizados com prompts
.cloud/ Configuração e histórico interno do Claude Code
plan.md, issue.md Armazenamento dos planos e tarefas
.git/ e worktrees Gestão de branches isoladas por agente
package.json (opcional) Dependências JS se forem usadas
aliases (cc, wt) Automatização e velocidade de uso no terminal

principais hacks e truques práticos citados no vídeo "Full Tutorial: Build an App with Multiple AI Agents (Claude Code)", utilizados por Kieran para tirar o máximo proveito do Claude Code com múltiplos agentes em paralelo:

1. Subagentes em Paralelo⌗

Hack: Rodar múltiplos Claude Codes simultaneamente para dividir o trabalho.

  • Ele usa worktree do Git para separar contextos e permitir múltiplas execuções ao mesmo tempo.
  • Cada subagente trabalha em uma tarefa isolada, como: modelo, serviço e interface.
  • Isso evita conflitos em arquivos e reduz tokens no contexto principal.

Exemplo de comando:

git worktree add ./email-feature feature-email cc # Roda Claude nesse diretório com permissão total

2. Alias personalizados no terminal⌗

Hack: Criar atalhos como cc para executar Claude com opções perigosas (--dangerously-skip-permissions) e economizar tempo.

Exemplo de alias:

alias cc="cloud run --dangerously-skip-permissions"

3. Comando mágico think ultra hard⌗

Hack: Usar expressões como think ultra hard ou think deeply para forçar Claude a raciocinar de forma mais profunda e usar o modelo Opus automaticamente.

Impacto:

  • Resultados mais bem fundamentados
  • Melhor qualidade em planos, estruturas e decisões arquitetônicas

4. create to-dos para controle de escopo⌗

Hack: Solicitar que o Claude crie uma lista de to-dos (tarefas) antes de executar qualquer código.

Vantagem:

  • Evita execução caótica
  • Permite revisão humana ou por outro agente

5. Uso de comandos slash (/issues, /review, etc.)⌗

Hack: Criar comandos reutilizáveis com .md no diretório /cloud/commands para automatizar tarefas frequentes.

Exemplos:

  • /issues → gera issues GitHub a partir de uma ideia
  • /review → revisão automatizada com diferentes “chapéus” (negócios, segurança, etc.)
  • /proofread, /best_practices, /fix_critical

6. Revisões multi-perspectiva⌗

Hack: Rodar múltiplas revisões em paralelo com diferentes perfis (ex: "engenheiro de segurança", "negócios", "estilo de cópia").

Resultado:

  • Cada agente analisa sob uma ótica diferente e gera comentários complementares

7. Uso de Markdown como PRD⌗

Hack: Toda instrução ou plano vira um arquivo .md com descrição clara, que pode ser:

  • Usado por outros agentes
  • Convertido em issue
  • Usado como documentação técnica

8. Utilização do GitHub CLI + Claude⌗

Hack: Claude interage com GitHub:

  • Cria pull requests
  • Analisa comentários
  • Implementa sugestões diretamente no repositório

9. Starter Projects para IA não se perder⌗

Hack: Utilizar starter kits com stack pré-definido (ex: Jumpstart Pro) ajuda Claude a seguir padrões corretos de projeto.

10. Configurar comandos de forma acumulativa⌗

Hack: Cada ação bem-sucedida é convertida em novo comando. Isso cria um repertório crescente de automações personalizadas.

11. Uso de voz com Whisper⌗

Hack: Ao invés de digitar, Kieran usa uma ferramenta chamada Monologue (baseada no Whisper) para enviar comandos por voz ao terminal.

12. Exploração assistida com teach me⌗

Hack: Claude pode ensinar sobre um projeto novo, explicar um repositório ou introduzir conceitos complexos se você pedir para ele ensinar algo.

13. Revisão com múltiplos bots⌗

Hack: Ele usa Claude + outros bots (como Charlie, com foco em TypeScript) para revisar o mesmo PR, garantindo múltiplos pontos de vista.

14. Aproveitar a CI da Claude (desde 2024)⌗

Hack: Claude agora permite rodar no GitHub diretamente (CI runner), evitando a necessidade de manter instâncias locais.

15. Controle por Branch + Worktree⌗

Hack: Cada subagente trabalha em uma branch separada, cada uma com seu worktree, evitando conflito de arquivos simultâneos.

No vídeo e no uso com Claude Code, o Git pode ser utilizado tanto localmente quanto integrado ao GitHub, dependendo da sua configuração e preferência. Veja como funciona nos dois casos:

1. Git local (sem GitHub)⌗

Claude Code pode operar inteiramente em ambiente local, usando o Git apenas para controle de versões entre branches e arquivos no seu computador:

  • Você pode criar branches e worktrees com:

git branch nova-feature git worktree add ./caminho/nova-feature nova-feature * O Claude pode criar, editar, commitar e navegar entre arquivos usando Git local. * É ideal para desenvolvimento em ambientes isolados, testes rápidos ou quando ainda não há repositório remoto.

Vantagens:

  • Mais rápido (sem internet).
  • Totalmente offline e privado.
  • Não exige autenticação no GitHub.

2. Integração com GitHub (repositório remoto)⌗

Quando você conecta o projeto ao GitHub, Claude Code também pode:

  • Criar Pull Requests automaticamente (create pull request)
  • Criar e comentar em issues do GitHub (/issues)
  • Usar comandos como /pr_comments e /review diretamente no repositório remoto.
  • Sincronizar alterações com:

git push origin minha-feature

Pré-requisitos:

  • Configuração do GitHub CLI (gh)
  • Login e autenticação com chave ou token
  • Repositório já criado e conectado ao projeto local (git remote add origin ...)

Vantagens:

  • Permite colaboração com outras pessoas e agentes.
  • Possibilita automações CI/CD.
  • Claude pode revisar e implementar alterações via pull requests.

3. Prática comum no vídeo⌗

Kieran usa uma mistura dos dois:

  • Git local com worktrees para rodar múltiplos agentes Claude em paralelo.
  • GitHub para abrir PRs, documentar pesquisas e permitir que agentes ou humanos revisem o trabalho.

Ele também usa comandos de voz e scripts alias para agilizar a rotina, como:

wt nova-feature # Cria worktree cc # Alias para rodar Claude em modo perigoso

Aqui está a lista simples, com cada comando seguido da explicação:

Comandos Claude Code e do Terminal⌗

claude Inicia o Claude Code no terminal.

cloud Executa o Cloud CLI, base para todos os subcomandos.

cloud init Inicializa um novo projeto Claude Code, criando a estrutura de pastas e arquivos.

cloud plan Entra em modo de planejamento, onde Claude pesquisa e organiza ideias antes de escrever código.

cloud chat Abre um chat com o Claude diretamente no terminal.

cloud login Faz login na conta Claude para autenticar o uso.

cc Alias personalizado para rodar cloud em modo de permissão total.

cloud run dangerously ou dangerously skip permissions Executa tudo sem pedir confirmação. É arriscado, recomendado apenas para quem sabe o que está fazendo.

cloud --model opus Força o uso manual do modelo Opus em vez do padrão.

@caminho-do-arquivo Inclui diretamente um arquivo no contexto do Claude usando o símbolo @.

Slash Commands (comandos internos do Claude)⌗

/issues Cria issues a partir de uma ideia ou tarefa.

/plan Inicia um plano de ação detalhado.

/review Revisa código ou conteúdo (muito usado em pull requests).

/research Pede pesquisa de melhores práticas antes de começar a programar.

/proofread Analisa e corrige estilo de textos e cópias.

/fix_critical Faz revisões em pontos críticos, com foco em segurança.

/best_practices Confere se o código segue boas práticas do framework usado.

/pr_comments Coleta e organiza comentários de um pull request para análise.

Palavras-chave de gatilho em prompts⌗

think ultra hard Pede ao Claude um raciocínio mais profundo e detalhado.

create to-dos Transforma uma solicitação em lista de tarefas.

think deeply ou think hard Alternativas para pedir um raciocínio mais estruturado.

yolo Ativa execução sem confirmações, equivalente ao modo perigoso.

Comandos Git + Worktree⌗

git worktree add Cria uma nova pasta com outra branch paralela do projeto.

wt Alias usado para simplificar a criação de worktree com o nome do recurso.

get worktrees Lista todas as worktrees existentes.

git checkout Troca para a branch desejada.

git commit Confirma as alterações feitas nos arquivos.

git push Envia as alterações confirmadas para o repositório remoto.

create pull request Cria uma pull request, seja via Claude ou GitHub CLI.

Outros comandos e práticas citadas⌗

slash command folder: cloud/commands Indica a pasta onde ficam os comandos .md personalizados.

use starter projects Sugestão de usar projetos base prontos, como Jumpstart Pro, para começar mais rápido.

reference blog posts Claude pode usar links de blogs ou artigos como referência de contexto.

context7 (MCP) Fonte de contexto curado para pesquisas mais precisas dentro do Claude.

youtube.com/watch ↗

Resumo completo do vídeo “Full Tutorial: Build an App with Multiple AI Agents (Claude Code)”

Apresentação e contexto Kieran, engenheiro líder e gerente geral do Kora (assistente de e-mail com IA), demonstra como utiliza o Claude Code para coordenar múltiplos agentes de IA trabalhando em paralelo como se fossem membros de uma equipe de engenharia. Essa abordagem vai além do vibe coding, que é mais experimental, e avança para agentic coding, onde o programador atua como um gestor delegando tarefas a agentes autônomos com instruções mais amplas e estruturadas.

Conceitos principais abordados no vídeo

  1. Vibe Coding vs Agentic Coding
  • Vibe coding: colaboração contínua com IA em ciclos rápidos (ideal para protótipos).
  • Agentic coding: IA assume tarefas maiores, como um colaborador que entende o escopo completo e entrega partes mais elaboradas com menos supervisão.
  1. Claude Code como ferramenta
  • Interface no terminal (ex: Warp).
  • Usa comandos como /issues, /review, /plan, /think ultra hard.
  • Organiza tarefas em to-dos e mantém contexto estruturado.
  1. Execução paralela com subagentes
  • Executa múltiplas tarefas simultaneamente sem sobrecarregar o contexto principal.
  • Cada subagente opera como um chat separado.
  • Reduz custo de tokens no contexto principal.
  • Permite construção de várias partes de um sistema ao mesmo tempo (ex: modelos, UI, serviços).
  1. Fluxo de trabalho automatizado
  • Kieran usa comandos de voz (com Whisper) para evitar digitação.
  • Estrutura tarefas em markdown (issues.md) e usa Git + work trees para separar execuções paralelas.
  • Automatiza o commit e push para GitHub.
  • Gera pull requests e usa o próprio Claude para revisar código com múltiplas “personalidades” (segurança, design, negócios etc.).
  1. Melhores práticas e hacks
  • Criar comandos reutilizáveis (/slash commands).
  • Usar starter projects (projetos com estrutura e bibliotecas prontas).
  • Pensar profundamente sobre o que será feito antes de delegar à IA (“think ultra hard”).
  • Automatizar revisões com múltiplos perfis de agentes IA.
  • Adaptar o workflow de acordo com seu estilo — não seguir gurus cegamente.
  1. Demonstração prática

  • Criação de um mini sistema que:

    • Lê e-mails falsos.
    • Resume conteúdo.
    • Armazena e-mails em banco de dados.
    • Gera interface para leitura e resumo.
    • A IA executa as partes em paralelo e gera resultados completos em minutos.
  1. Apresentação do Kora

  • Assistente de e-mail inteligente que:

    • Filtra e organiza e-mails por importância.
    • Resume conteúdos.
    • Sugere ações.
    • Aprimora-se com o uso contínuo do usuário.
    • Produto criado por Kieran com forte feedback positivo.

Resumo em tópicos com exemplos e respostas

  1. O que é Claude Code?
  • Ferramenta no terminal para trabalhar com agentes de IA que executam tarefas complexas.
  • Ex: “Claude, crie modelos de banco de dados para armazenar e-mails.”
  1. Como funciona a paralelização?
  • Criação de subagentes que atuam simultaneamente em tarefas diferentes.
  • Ex: um agente desenvolve a API, outro a interface e outro a lógica de negócios.
  1. Quais comandos e práticas são importantes?
  • think ultra hard → ativa processamento mais profundo (usa modelo Opus).
  • create to-dos → divide tarefas grandes em subtarefas.
  • slash commands → atalhos personalizados como /issues, /review.
  1. Como fazer revisão de código com IA?
  • O próprio Claude pode revisar PRs com diferentes perspectivas.
  • Ex: “Reveja esse código como se fosse um engenheiro de segurança.”
  1. Quais são os maiores aprendizados?
  • IA é melhor usada como colega de equipe, não apenas como assistente de código.
  • O desafio maior está na pesquisa e no planejamento, não na codificação em si.
  • Reutilização e documentação são chave: transforme tudo em comandos reutilizáveis.
  1. Dica para iniciantes
  • Comece pequeno, com tarefas simples e vá evoluindo.
  • Ex: use Claude para analisar um trecho de código ou revisar um texto.

“Full Tutorial: Build an App with Multiple AI Agents (Claude Code)”

chatgpt.com ↗

1

Recursos

↑ voltar ao topo · ver no Telegram ↗