Construindo uma Plataforma SaaS de Produção com Mais de 20 Mil Linhas de Código com Claude Code: Lições da Engenharia de Agentes em Escala

Visão Geral do Projeto

O LastSaaS é um boilerplate SaaS pronto para produção, com cada linha escrita por meio de conversa com o Claude Code. Não é uma demonstração ou brinquedo—ele alimenta uma plataforma ativa chamada Flipbook. A stack inclui Go 1.25, React 19, TypeScript, MongoDB e Tailwind, lançada sob licença MIT.

O que o Projeto Inclui

• Base completa para SaaS com autenticação multi-inquilino (OAuth, MFA, links mágicos, rotação de JWT)
• Faturamento via Stripe (assinaturas, por usuário, créditos)
• Capacidades de white-label
• 19 tipos de eventos de webhook
• Painel administrativo e monitoramento de saúde
• Servidor MCP integrado com 26 ferramentas somente leitura que permitem assistentes de IA consultar dashboards, usuários, faturamento e dados de saúde

O que Funcionou

A explicitude do Go é uma vantagem para agentes: Sem mágica de framework significa que o Claude Code não precisa adivinhar o que o middleware está fazendo nos bastidores. Tratamento explícito de erros, roteamento claro e padrões previsíveis ajudam o agente a se manter no caminho certo.

Padrões consistentes se multiplicam: Estabelecer padrões desde o início para como handlers, serviços e acesso a dados são estruturados permitiu que o Claude os replicasse em dezenas de endpoints com alta consistência, reduzindo drasticamente o custo de cada nova funcionalidade.

O servidor MCP foi construído pelo Claude para o Claude: As 26 ferramentas somente leitura criam uma interface meta onde a IA construiu sua própria maneira de consultar o sistema.

O modelo de documento do MongoDB simplificou a multi-inquilino: O Claude não teve dificuldade em manter o isolamento de inquilinos porque o modelo de dados torna os limites explícitos, evitando confusão com tabelas de junção e abstrações vazadas.

O que Exigiu Disciplina

Você ainda precisa de visão arquitetônica: O Claude Code é um executor brilhante, mas não projeta sistemas. O humano deve fornecer a arquitetura—sabendo como o RBAC multi-inquilino deve ser, como as tentativas de entrega de webhook devem funcionar e qual deve ser o fluxo de integração do Stripe.

Revise tudo: Especialmente código sensível à segurança como rotação de JWT, assinatura HMAC, limitação de taxa e proteção contra injeção. O Claude acerta na maioria das vezes, mas "na maioria das vezes" não é bom o suficiente para fluxos de autenticação—cada linha relacionada à segurança precisa de revisão humana.

Combata a deriva de padrões: Em sessões longas, o Claude pode derivar sutilmente dos padrões estabelecidos. Reancorar periodicamente a conversa ajuda: "Veja como implementamos o handler de usuário. Siga o mesmo padrão para webhooks."

O Conceito "Construído para Agentes"

A base de código é intencionalmente estruturada para que, quando alguém a bifurcar e apontar seu próprio agente de IA para ela, o agente possa estendê-la fluentemente. Isso inclui estrutura de arquivos previsível, nomenclatura consistente e padrões explícitos—uma base projetada para ser estendida por meio de conversa.

O repositório está disponível em https://github.com/jonradoff/lastsaas.