00:00:00A verdade é que a IA nunca revolucionará o processo de criação de software, pelo menos não da forma que você pensa.
00:00:05Com certeza torna tudo mais rápido, e também facilita a recuperação quando as coisas dão errado.
00:00:10Mas os processos estabelecidos ao longo de 60 anos de criação de produtos ainda são tão importantes hoje, apenas por razões diferentes,
00:00:16antes eram implementados para garantir que os humanos tivessem uma forma estruturada de desenvolver esses produtos.
00:00:21Mas agora isso mudou para permitir que agentes de IA trabalhem da mesma forma que os humanos.
00:00:25Portanto, para fazer os agentes de IA funcionarem corretamente, você precisa configurar o ambiente deles da maneira certa para que eles realmente sigam o processo.
00:00:32E vamos passar por todas as etapas que você precisa seguir antes mesmo de começar a construir.
00:00:36Planejar seus requisitos adequadamente é a coisa mais importante que você faz antes de escrever um único prompt.
00:00:41Esta é a parte em que, não importa o quão bons os modelos se tornem, você precisará dedicar tempo.
00:00:45Agora, existem várias formas de planejamento.
00:00:46Você pode planejar seu app usando o Claude Code no modo de planejamento, mas o planejamento dele é muito focado no técnico, não no produto.
00:00:52Como mencionamos no vídeo anterior, com a forma como os agentes estão progredindo,
00:00:56o modo de planejamento não precisa ser tão detalhado ou técnico e deve, em vez disso, focar pesadamente no aspecto do produto
00:01:01porque os novos modelos são poderosos e o planejamento tem que ser diferente de como costumava ser com os primeiros modelos pouco capazes.
00:01:07Então, em vez do modo de planejamento do Claude, você pode criar outro agente para ajudar a planejar seu app.
00:01:11Ele contém as instruções para ajudar a construir um PRD adequado com um template para guiar o Claude sobre quais exatamente são os requisitos.
00:01:18Depois de configurar o agente, você pode dar um prompt ao Claude para usá-lo e planejar o app que deseja construir.
00:01:23Ele carrega o agente planejador e continua fazendo perguntas até entender todos os requisitos.
00:01:28Ele continua fazendo perguntas até que você esteja satisfeito com o planejamento.
00:01:32Agora, para entender o MVP, o agente é projetado para fazer muitas perguntas.
00:01:36E no final, ele perguntará se há mais alguma coisa que você precisa no seu app.
00:01:40Se houver, você pode adicionar as coisas que deseja que o agente implemente.
00:01:43Se você estiver satisfeito com todas as perguntas e achar que o agente entendeu o plano, pode apenas dizer que é isso.
00:01:49Após a sessão de perguntas e respostas, ele cria um documento PRD e o salva na pasta do projeto.
00:01:54Este documento contém detalhes sobre todos os requisitos que vocês discutiram.
00:01:57A implementação é dividida em fases e contém todas as principais decisões de design e tudo o que é necessário para o app.
00:02:04Agora que você refinou qual app deseja construir, o próximo passo é definir adequadamente um arquivo Claude.md.
00:02:10Este arquivo é importante porque contém todas as instruções que você deseja que seu agente siga.
00:02:15Você vincula o documento PRD para que ele possa acessar todos os requisitos do app diretamente de lá e você não precise repetir nada aqui.
00:02:21Este arquivo deve conter apenas as coisas que o agente não sabe, em vez de mencionar as coisas que ele já sabe.
00:02:27Ele referencia as regras que você deseja que o projeto siga.
00:02:30Você pode adicionar as convenções do seu projeto e todas as instruções que deseja que o Claude siga especificamente ao implementar o app.
00:02:37A abordagem ideal é que você não crie o arquivo Claude.md a partir do comando init e, em vez disso, o crie por conta própria
00:02:43porque esse comando apenas gera o arquivo com base em como é a base de código existente, não no que ela realmente precisa saber.
00:02:49Mas este arquivo não é um arquivo de escrita única que você configura e esquece.
00:02:53Você precisa continuar adicionando coisas a ele para que ele possa melhorar incrementalmente o processo de criação de apps enquanto você trabalha.
00:02:58Agora, como falamos em nosso vídeo anterior, este arquivo é carregado uma vez e permanece no contexto para sempre, atuando como uma diretriz enquanto trabalha.
00:03:05Portanto, certifique-se de que este arquivo não contenha coisas que não são realmente necessárias ou que sejam específicas de uma área de implementação.
00:03:12As coisas que você precisa adicionar a este arquivo são as melhores práticas que seu projeto seguirá, suas convenções de codificação, seu estilo de escrita e convenções,
00:03:19e outras coisas semelhantes, mas não as coisas que ele pode descobrir por conta própria, como a estrutura do projeto.
00:03:24Para isso, ele pode ler a estrutura de arquivos e entendê-la por si mesmo.
00:03:28Portanto, leve o tempo necessário ao escrever este arquivo e garanta que ele esteja devidamente adaptado às suas necessidades e ao seu projeto antes de implementar o app.
00:03:36A próxima coisa que você configura são suas habilidades, agentes e qualquer MCP que queira usar no seu projeto, tudo antes de realmente construí-lo.
00:03:42MCPs são mais fáceis de conectar.
00:03:44Você pode apenas conectar qualquer serviço externo que deseje que o agente acesse e instalá-los executando seus comandos de instalação.
00:03:50Por exemplo, queríamos nosso backend construído no Supabase, então conectamos o MCP do Supabase ao nosso agente no projeto.
00:03:57Se você estiver usando Shadcn UI para componentes de interface e Playwright para testes de navegador,
00:04:01você precisa tê-los todos conectados antes de construir o app para que os agentes possam acessar essas ferramentas durante a construção.
00:04:07Mas esses foram apenas para conectar a serviços externos; você também precisa configurar agentes.
00:04:12Você pode configurar quantos agentes forem necessários.
00:04:14Você já tem um agente planejador dedicado para o planejamento.
00:04:16Você também pode criar um agente de commit que é responsável por fazer commits, executar pré-verificações e seguir mensagens de commit convencionais.
00:04:23Você pode ter um agente de refatoração que refatora o código e melhora o desempenho geral.
00:04:28E você pode ter um agente de verificação que usa as ferramentas do MCP do Playwright para verificar se a interface e o fluxo do usuário estão funcionando como pretendido.
00:04:39Agora, além dos agentes, você também precisa configurar habilidades (skills).
00:04:42Você pode criar quantas habilidades precisar e pode criá-las facilmente usando o Skill Creator, que está disponível no repositório open source do GitHub.
00:04:49Você pode adicionar quantas referências quiser e também incluir scripts para que ele possa executar o script diretamente e usar sua saída.
00:04:55Para a distinção entre quando usar agentes e quando usar habilidades, implemente como habilidades todos os fluxos de trabalho que são repetíveis e precisam de orientação e referências.
00:05:04Por exemplo, você pode criar uma habilidade de front-end porque é um fluxo de trabalho repetível e precisa seguir diretrizes dedicadas de forma consistente em todo o app.
00:05:11Implemente agentes para tarefas que precisam de uma janela de contexto dedicada.
00:05:14Você também pode usar a habilidade de front-end que é open source e é usada ativamente pelo próprio criador do Claude Code.
00:05:20Você também precisa adicionar regras específicas de caminho para aspectos específicos do seu app.
00:05:23Essas regras definem o caminho ao qual se aplicam e incluem todas as instruções necessárias para implementar essa parte específica.
00:05:29Você pode configurar quantas dessas quiser e também vinculá-las no seu Claude.md para que o agente saiba que tem que seguir estas instruções.
00:05:36Como mencionamos antes, o Claude.md é para princípios amplos, por isso você tem regras de caminho adaptadas a partes específicas para que o agente saiba o que fazer.
00:05:46Cobrimos todas essas configurações e muito mais sobre a construção de produtos com IA neste canal, então, se quiser ver mais disso, inscreva-se.
00:05:54Mas mesmo com todas essas instruções positivas, ainda há uma lacuna.
00:05:58Os agentes são tendenciosos para a ação e podem implementar coisas além do que suas restrições positivas especificam.
00:06:03Portanto, você precisa dizer explicitamente ao agente o que ele não deve fazer.
00:06:06Você pode criar este arquivo na sua pasta docs e vinculá-lo no Claude.md para que o agente saiba que essas restrições existem.
00:06:12Ele deve conter todas as instruções adaptadas ao projeto, especificando tudo o que você não quer que o agente crie.
00:06:19Restrições negativas são importantes porque especificações positivas deixam uma lacuna implícita, e as negativas fecham essa lacuna, removendo ambiguidades.
00:06:29Elas dão um objetivo mais claro do que o resultado não deve parecer.
00:06:32Por exemplo, se você não quer que a IA siga a combinação padrão de roxo ou azul e branco, diga explicitamente que não quer isso em vez de apenas sugerir.
00:06:41Mas antes de seguirmos em frente, uma palavra do nosso patrocinador, Way in Video.
00:06:44Se você trabalha com vídeos longos, conhece a dificuldade. Horas vasculhando filmagens só para encontrar um bom momento, e mais tempo editando.
00:06:52O Way in Video resolve tudo isso. É uma plataforma de vídeo com IA que realmente entende o seu vídeo.
00:06:56A habilidade de clipping de IA deles no OpenClaw pega qualquer vídeo longo, encontra os momentos mais virais, reformata para vertical e adiciona legendas.
00:07:04Sem código, sem configuração. Basta executar a habilidade e seus clipes estão prontos para postar. Simples assim.
00:07:08Se quiser algo específico, pode pesquisar dentro de qualquer vídeo usando inglês simples. Digite "funny reaction" ou "best quote" e ele pula direto para lá.
00:07:16Ele também lida com resumos de vídeo e transcrições com identificação de locutores. Perfeito para podcasts, palestras e transmissões.
00:07:22Seja para reaproveitar conteúdo ou automatizar seu fluxo de trabalho, o Way in Video economiza horas todas as semanas.
00:07:27Pare de perder tempo com edição manual. Clique no link no comentário fixado para começar.
00:07:32Agora, isto é algo que a maioria dos frameworks de IA usa de uma forma ou de outra: usar múltiplos documentos para diferentes propósitos.
00:07:38Mas o núcleo por trás de todos esses documentos é o documento de progresso e aprendizado.
00:07:42O arquivo de progresso é crítico porque, ao trabalhar em um app de grande escala com várias funções, o agente perde o rastro do que já implementou.
00:07:52Sem este arquivo, o agente tem que voltar, ler a implementação e compará-la com os documentos para descobrir o que foi feito.
00:07:58Isso cria sobrecarga e desperdiça tempo e tokens.
00:08:01Portanto, crie um arquivo de progresso onde o agente possa olhar em um só lugar e saber exatamente onde as coisas estão.
00:08:07Mas rastrear o progresso sozinho não é suficiente, pois o agente também precisa saber o que deu errado.
00:08:11Portanto, você também precisa de um arquivo de aprendizados onde o agente registra seus erros, o que os causou e como os corrigiu.
00:08:17Dessa forma, quando encontrar uma situação semelhante mais tarde, ele não cometerá o mesmo erro duas vezes.
00:08:22Como ambos os arquivos devem ser atualizados ativamente durante a implementação do app,
00:08:26você precisa instruir explicitamente o agente no Claude.md para que ele continue adicionando a esses arquivos, melhorando sua base de conhecimento.
00:08:34Agora, estes dois arquivos são os mais essenciais que toda configuração precisa.
00:08:38Você pode usá-los quando estiver construindo sua própria configuração de codificação.
00:08:41Também fizemos anteriormente um vídeo que fala sobre como você pode construir os frameworks por conta própria, que você pode ver no canal.
00:08:46Mas se você não quiser passar pelo incômodo de configurar o seu próprio,
00:08:49pode apenas contar com os frameworks de codificação, pois eles usam mecanismos diferentes para fazer exatamente isso que você pode implementar diretamente.
00:08:56Outro erro comum é implementar testes apenas ao final do desenvolvimento.
00:09:00Isso é problemático porque se você pedir a um agente para escrever e implementar testes após as funcionalidades serem construídas,
00:09:05os testes não serão tão eficazes quanto seriam se tivessem sido escritos antes.
00:09:09Ao escrever testes, você deve fazer com que o agente consulte o PRD que você criou e, com base nisso, deduza como a funcionalidade deve funcionar.
00:09:16O agente deve então escrever os testes a partir desses requisitos deduzidos,
00:09:19essencialmente fazendo engenharia reversa da funcionalidade e dos pontos onde o app pode falhar a partir do PRD.
00:09:24Assim que os testes estiverem prontos, você pode executá-los no final para verificar se a implementação atende aos requisitos.
00:09:29O motivo para escrever os testes primeiro é que, se você os implementar depois, o agente só saberá o que foi realmente implementado.
00:09:35Ele otimizará os testes para as funções como elas existem, não para a funcionalidade exigida nas especificações.
00:09:41Isso pode fazer com que você deixe de testar recursos que foram especificados, mas não implementados corretamente.
00:09:46Como o agente otimiza para a abordagem implementada, ele pode relaxar em testes rigorosos,
00:09:50perdendo casos de borda que poderiam ter sido capturados se os testes viessem diretamente das especificações.
00:09:55Você não deve dar ao agente instruções abertas como "teste a aplicação" porque assim o Claude apenas otimiza para a implementação.
00:10:02Em vez disso, implemente testes adequados guiados pelas especificações para que o agente saiba exatamente o que otimizar.
00:10:07Além disso, se estiver gostando do nosso conteúdo, considere apertar o botão de hype, pois isso nos ajuda a criar mais conteúdos como este.
00:10:14Outro problema que muitas pessoas encontram no desenvolvimento de apps é a falta de rastreamento antecipado de problemas.
00:10:19Sem isso, os problemas se acumulam sem registro do que os causou e, conforme o app cresce, fica mais difícil rastrear.
00:10:26Portanto, manter logs adequados durante os testes é crucial.
00:10:29Muitas pessoas usam o GitHub para isso, e o GitHub é uma excelente plataforma para rastrear e gerenciar problemas.
00:10:34Combiná-lo com mensagens de commit bem estruturadas fornece orientação ao Claude sobre o que foi feito em cada commit e permite rastrear o progresso.
00:10:42Uma das melhores características do Git é que, se uma alteração quebrar a base de código, você pode reverter os commits.
00:10:47E se quiser testar algo experimental, pode usar a worktree para fazer isso de forma isolada.
00:10:51Você pode configurar sua estrutura para que o agente faça commit após cada implementação usando mensagens detalhadas para manter a clareza.
00:10:58Mas o GitHub funciona bem para usuários técnicos; membros não técnicos da equipe podem ter dificuldade em enviar problemas.
00:11:03Portanto, para eles, conectar o agente a uma ferramenta de gerenciamento de projetos como Trello ou Notion é o ideal.
00:11:08Isso permite registrar problemas, rastrear o progresso e colaborar em correções.
00:11:12Você deve conectar o MCP da respectiva ferramenta para que o agente possa acessá-la, rastrear bugs e gerenciar relatórios com eficiência.
00:11:20Você também precisa adicionar uma instrução no Claude.md especificando que o agente deve usar o MCP do Notion para rastrear bugs corretamente.
00:11:28Configurar isso no início é inestimável conforme o projeto cresce e várias pessoas começam a desenvolver juntas.
00:11:36Mas mesmo que seu app funcione perfeitamente nos testes, o código gerado por IA não é inerentemente construído para lidar com vários usuários simultâneos.
00:11:43É por isso que muitas pessoas acham que as implementações de IA têm desempenho insatisfatório em produção.
00:11:47Portanto, você precisa se preparar para isso também.
00:11:49Se você tiver uma estimativa, pode dizer ao seu agente o número esperado de usuários e que vários usuários usarão o app ao mesmo tempo.
00:11:56O agente deve então escrever os casos de teste para o teste de estresse da carga com base nessa informação.
00:12:01Existem várias ferramentas de teste que você pode usar e escolher a que melhor se adapta aos seus requisitos.
00:12:05Usamos o K6 para um app Next.js porque é fácil de implementar e atendia aos nossos requisitos.
00:12:10Você também pode usar o modo de plano do Claude aqui para mapear várias abordagens, pois aqui precisamos de um plano técnico detalhado.
00:12:17O Claude planeja com base no PRD e no número aproximado de usuários que você espera que o usem simultaneamente.
00:12:23O Claude faz várias perguntas de diferentes perspectivas e esclarece possíveis problemas que poderiam surgir em produção.
00:12:29Isso ajuda o app a falhar graciosamente, mesmo que ocorram problemas, e garante que a experiência do usuário seja otimizada.
00:12:34Usando este modo, você pode esclarecer sua intenção e fazer o agente planejar também a escalabilidade.
00:12:39Este plano se torna a peça final para levar seu app de uma ideia até a prontidão para produção.
00:12:43Agora, todos esses agentes e habilidades mencionados aqui estão disponíveis no AI Labs Pro para este vídeo e para todos os nossos vídeos anteriores.
00:12:53Se você encontrou valor no que fazemos e quer apoiar o canal, esta é a melhor maneira de fazer isso.
00:12:57O link está na descrição.
00:12:59Isso nos traz ao final deste vídeo.
00:13:00Se você quiser apoiar o canal e nos ajudar a continuar fazendo vídeos como este, pode fazê-lo usando o botão de Super Thanks abaixo.
00:13:07Como sempre, obrigado por assistir e vejo você no próximo.