Education

Como estou usando o Claude Code em projetos full-stack (monorepo e regras)

by Rocketseat

Share:

✨ Principais tópicos

  • Monorepo para projetos full-stackManter API, frontend e outros pacotes no mesmo repositório facilita mudanças que envolvem várias partes do projeto e ajuda a manter os deploys alinhados. 0:31
  • Regras divididas por contextoEm vez de concentrar todas as instruções em um único arquivo, o autor organiza regras em arquivos específicos para áreas como API, autenticação, banco de dados, eventos e dashboard. 3:34
  • Construção de uma feature completaO exemplo proposto é criar uma listagem de contatos, seguindo a referência de broadcasts e cobrindo backend, testes, rotas e interface. 6:11
  • Documentação e ferramentas de APIA documentação Swagger ajuda o agente a entender as rotas, enquanto o Kubb gera hooks tipados para o frontend a partir da API. 9:17
  • Mocks para testes no frontendMocks integrados ao Faker permitem testar a interface sem depender de o backend estar rodando. 10:49

🧠 Principais aprendizados

  • Contexto compartilhadoEm um monorepo, o agente pode considerar as mudanças no backend ao trabalhar no frontend, entendendo quais parâmetros enviar e quais dados esperar. 2:02
  • Instruções específicas e enxutasRegras por diretório ajudam o agente a seguir padrões relevantes sem carregar documentação extensa e genérica em todos os contextos. 4:06
  • Documentar padrões em vez de caminhosNomes de arquivos e pastas podem mudar; por isso, é mais útil registrar convenções e padrões que permanecem válidos. 3:04
  • Planejar antes de implementarO autor usa o modo de planejamento para explorar a estrutura existente e organizar as etapas antes de pedir a implementação. 6:11

📚 Lições aprendidas

  • Alinhar releasesUma pipeline de deploy unificada reduz o risco de frontend e backend ficarem em versões incompatíveis durante uma publicação. 1:01
  • Usar exemplos existentesApontar uma feature semelhante, como a listagem de broadcasts, dá ao agente uma referência concreta para planejar a nova implementação. 8:16
  • Revisar e detalhar os promptsO plano gerado é um ponto de partida; prompts reais podem precisar de mais ajustes e detalhes antes da execução. 11:50

🏁 Conclusão e próximos passos

  • Aplicar a abordagem ao projetoPara projetos pessoais ou SaaS, o autor recomenda combinar monorepo, regras organizadas por contexto e agentes de código para desenvolver features de ponta a ponta. 12:21
  • Sugestões para novos vídeosO autor convida o público a comentar quais temas gostaria de ver no canal em 2026. 12:52

Transcript excerpt

0:00 Fala, beleza? Mais um vídeo aqui pro YouTube da Rocketseat. Primeiro vídeo onde eu apareço aqui em 2026. Antes de mais nada, feliz ano Novu. E nesse vídeo eu quero te mostrar um pouquinho de como que eu venho desenvolvendo projetos full stack, utilizando agentes de código. Mais especificamente aqui eu tenho utilizado bastante o Claude Code, mas não interessa se você tá usando Open Code, Codex ou qualquer outro agente, código, cursor por si só. A gente vai entender um pouquinho de como você pode organizar melhor as regras aí do seu agente, dividir o seu projeto e construir features de cabo a rabo desde o back end pro end. Eu já vou abrir minha tela aqui e te mostrar pra gente não perder tempo.

0:31 E a primeira dica que eu te dou aqui, antes de mais nada, pra gente já começar passando a régua nisso é se você vai desenvolver um projeto full-stack, onde você é o único desenvolvedor ou você tem mais um amigo ou dois amigos aí que estão desenvolvendo, você quer criar um SaaS junto com essa pessoa, não existe forma melhor de você começar esse projeto do que senão utilizando a feature de workspaces, que são basicamente a a feature de monorepo, onde você tem todo o seu projeto, seja API, front end, tudo isso dentro de um único repositório. Isso aqui permite a gente fazer muitas coisas. Primeira delas, a gente consegue

🔒 The full, searchable transcript is available with Pro.

🔒 Unlock Premium Features

This is a premium feature. Upgrade to unlock unlimited Q&A, transcripts, mindmaps, and translations.

🔒 Unlock Premium Features

Access to Chat is a premium feature. Upgrade now to unlock unlimited studying tools.

🔒 Unlock Premium Features

Access to Mindmap is a premium feature. Upgrade now to unlock unlimited studying tools.

🔒 Unlock Premium Features

Access to Translation is a premium feature. Upgrade now to unlock unlimited studying tools.

Key Topics

Get unlimited summaries, Q&A, transcripts and more with Pro

Upgrade to Pro

Suggestions

🔒 Unlock Premium Features

Access to AI Suggestions is a premium feature. Upgrade now to unlock unlimited studying tools.