Para devs AI-native / CLAUDE CODE
Um boilerplate SaaS
onde o Claude Code consegue trabalhar
O CLAUDE.md diz as regras ao Claude Code. Hooks, ESLint e CI fazem com que ele as cumpra. Aqui estão os arquivos exatos que o useDeploy traz para cada coisa, e onde a garantia termina.
Como o Claude Code carrega suas regras
Segundo a documentação oficial de memória (https://code.claude.com/docs/en/memory), o Claude Code lê o CLAUDE.md no início de cada sessão, a partir de ./CLAUDE.md ou ./.claude/CLAUDE.md, e também pode ler o AGENTS.md do repositório no lugar do CLAUDE.md. A mesma página é explícita sobre o limite: o Claude trata o CLAUDE.md como contexto, não como configuração forçada, e para bloquear uma ação independentemente do que o Claude decidir usa-se um hook PreToolUse. Regras em um arquivo são um pedido. O cumprimento mora em hooks, lint e CI.
O que o useDeploy traz hoje, arquivo por arquivo
| Arquivo no repo | O que faz | Quem faz cumprir |
|---|---|---|
| CLAUDE.md | Manual de operação longo: camadas DDD, contratos, regeneração da API, regras de docs, design system. | Só contexto. O Claude Code lê no início da sessão. |
| AGENTS.md | Regras curtas de arquitetura: camadas, contratos, "pronto é verde". Qualquer agente que leia o AGENTS.md as recebe. | Contexto que o agente lê. As regras que ele enuncia são sustentadas pelas regras de camadas do ESLint. |
| .claude/settings.json | Registra os dois hooks do Claude Code (PostToolUse e Stop). | Só Claude Code. |
| .claude/hooks/lint-edited-file.mjs | Hook PostToolUse: roda o lint em cada arquivo que o agente acabou de editar e devolve o relatório do ESLint no mesmo turno. | Só Claude Code. Avisa depois da edição; não a bloqueia. |
| .claude/hooks/verify-before-stop.mjs | Hook Stop: se o agente tenta terminar e o bun run guardrails falha, ele o manda de volta uma vez com o erro. | Só Claude Code. Uma nova tentativa forçada, não uma garantia. |
| packages/eslint-config/ddd.js | Regras de camadas do ESLint: domain e application não podem importar express, Prisma nem BetterAuth; os contextos conversam por tipos. | Qualquer ferramenta, qualquer editor. É o que o agente não consegue contornar na conversa. |
| .github/workflows/ci.yml | Os jobs de lint e typecheck rodam em cada pull request (o de testes também). | Qualquer ferramenta. É o portão compartilhado. |
O que o useDeploy não traz para o Claude Code
Não há hook PreToolUse: nada impede uma edição antes de ela acontecer. O hook de lint avisa logo depois da edição e o hook Stop força uma única nova tentativa, então um erro que o agente não sabe corrigir chega até o CI, que é o portão de verdade. Também não trazemos uma biblioteca de skills de projeto para o SaaS em si (a pasta .claude tem os hooks, um subagente code-smell e algumas skills de integração com WhatsApp). Se você quer um bloqueio com PreToolUse, o kit é o lugar para estender.
Comparação honesta: os outros também trazem arquivos para agentes
O useDeploy é o nosso produto, então leve isso em conta. MakerKit, supastarter, Nextbase, ShipAny e Indie Kit também trazem um AGENTS.md, arquivos de regras ou skills de agentes para ferramentas de IA, e o AnotherWrapper vende um harness de hooks bloqueantes ("Hooks, not instructions"). O que o useDeploy soma ao AGENTS.md é a combinação de regras de camadas do ESLint, hooks do Claude Code e um portão de CI no mesmo repositório. Não é o único kit com arquivos para agentes, e um arquivo de regras sozinho, nosso ou de qualquer um, é só um pedido.
O kit open source e os guias
Leve os guardrails sem o boilerplate
Os hooks e o settings estão publicados como um kit MIT: https://github.com/KonixDev/claude-code-guardrails. Coloque em qualquer repositório que tenha config de ESLint e um script guardrails.
Escreva os arquivos você mesmo
Guias (em inglês): /blog/claude-md-file-example-saas (CLAUDE.md), /blog/claude-code-hooks-enforce-architecture (hooks), /blog/cursor-rules-nextjs-typescript (regras do Cursor), /blog/claude-code-skills-subagents-architecture-review (skills e subagentes).
Compare os kits
Ranking por caso de uso (em inglês), incluindo os casos em que outro kit serve melhor.
Outras ferramentas de IA
Cursor
Como o Cursor carrega suas regras e o que o useDeploy cobre para ele.
OpenAI Codex
Como o OpenAI Codex carrega suas regras e o que o useDeploy cobre para ele.
Windsurf
Como o Windsurf carrega suas regras e o que o useDeploy cobre para ele.
GitHub Copilot
Como o GitHub Copilot carrega suas regras e o que o useDeploy cobre para ele.
AGENTS.md
Como o AGENTS.md carrega suas regras e o que o useDeploy cobre para ele.
Agentes de código com IA: o panorama
A visão geral dos guardrails que toda ferramenta de IA compartilha: regras de camada, contratos tipados e o gate de CI.
Perguntas frequentes
O Claude Code precisa do CLAUDE.md ou pode usar o AGENTS.md?+
Os hooks garantem que o agente não quebre a arquitetura?+
Quanto custa o useDeploy?+
| Preço | Founder $99 ou Lifetime $199, pagamento único (sem assinatura) |
|---|---|
| Licença | Código-fonte completo, uso comercial, projetos ilimitados. O Founder é uma versão congelada; o Lifetime inclui todas as versões futuras. |
| Stack | Frontend em Next.js, API em Express, runtime Bun, Prisma, BetterAuth |
| Autenticação | BetterAuth: sessões, 2FA, magic links, redefinição de senha |
| Multi-tenancy e RBAC | Organizações com membros, convites, papéis e permissões |
| Pagamentos | Polar: cobrança completa (checkout, portal do cliente, webhooks, sincronização de planos). MercadoPago: pagamentos únicos com Checkout Pro e webhooks assinados; as assinaturas ainda não são suportadas. Stripe: scaffold de adapter, ainda não cobra. |
| Guardrails para agentes de IA | Camadas de arquitetura forçadas com ESLint, hooks do Claude Code e um AGENTS.md |
| Reembolso | 14 dias |
| Teste: conta grátis | Cadastre-se grátis e explore o dashboard: organizações, papéis, cobrança, log de auditoria. A licença é comprada por dentro. https://usedeploy.dev/register |
| Docs | Documentação em inglês, com traduções para espanhol e português dos guias principais |
Regras que o agente lê, paredes que ele não atravessa.
Comece de uma base em que a arquitetura é imposta por lint e CI, e os arquivos para agentes já estão escritos.