Para devs AI-native / CODEX
Um boilerplate SaaS
que o Codex lê desde o primeiro prompt
O Codex pega as regras do projeto no AGENTS.md. O useDeploy traz um e o sustenta com lint e CI, porque neste repositório o Codex não tem hooks.
Como o Codex carrega suas regras
Segundo o guia oficial do AGENTS.md (https://learn.chatgpt.com/docs/agent-configuration/agents-md), o Codex monta suas instruções quando uma execução começa. Primeiro olha o seu Codex home (~/.codex por padrão) e usa só o primeiro arquivo não vazio de lá, AGENTS.override.md antes do AGENTS.md. Depois parte da raiz do projeto e desce em direção ao diretório atual, incluindo no máximo um arquivo por diretório. Os arquivos são combinados da raiz para baixo, então os mais próximos do seu diretório de trabalho sobrescrevem a orientação anterior. O carregamento para quando o tamanho combinado chega a project_doc_max_bytes, 32 KiB por padrão. O AGENTS.md da raiz do useDeploy tem cerca de 40 linhas, bem abaixo disso.
O que o useDeploy traz hoje, arquivo por arquivo
| Arquivo no repo | O que faz | Quem faz cumprir |
|---|---|---|
| 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. |
| 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. |
| 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. |
O que o useDeploy não traz para o Codex
Não há pasta .codex nem configuração específica do Codex; o AGENTS.md é toda a integração. Os hooks de .claude são só do Claude Code e não rodam no Codex. Isso deixa o lint e o CI como a imposição numa sessão do Codex: o AGENTS.md pede ao agente que rode bun run guardrails antes de terminar, mas nada o obriga. Também não incluímos AGENTS.md aninhados por módulo; o da raiz cobre o repositório.
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
Claude Code
Como o Claude Code carrega suas regras e o que o useDeploy cobre para ele.
Cursor
Como o Cursor 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
Preciso de um arquivo específico do Codex?+
A configuração de hooks do Claude Code serve para o Codex?+
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.