Para devs AI-native / AGENTS.MD
AGENTS.md para um SaaS,
e o que ele não consegue impor
Um arquivo curto que vários agentes de código leem. O useDeploy traz um real, de 40 linhas, ligado às regras de lint que fazem dele mais do que uma sugestão.
O que é o AGENTS.md e quem o lê
Segundo o agents.md (https://agents.md), o AGENTS.md é um arquivo aberto, baseado em Markdown, que dá contexto do projeto aos agentes de código: "um README para agentes". O site lista como compatíveis o Codex, o Cursor, o coding agent do GitHub Copilot, o Windsurf, o Gemini CLI, o Jules, o Zed, o Warp, o Devin e outros. Em monorepos você pode colocar um em cada subprojeto; os agentes leem o arquivo mais próximo na árvore de diretórios, então vence o mais próximo, e os prompts explícitos do usuário no chat sobrescrevem tudo. O Claude Code também pode lê-lo, no lugar do CLAUDE.md. Continua sendo um arquivo de texto: o agente pode ignorá-lo.
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. |
| 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. |
| 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. |
| .cursor/rules/architecture.mdc | Regra do Cursor restrita aos módulos do server (regras de camadas, aponta para o AGENTS.md). | Só Cursor. Uma regra é contexto, não um bloqueio. |
O que um AGENTS.md real contém aqui, e o que deixa de fora
O AGENTS.md do useDeploy tem o layout do server como uma tabela de quatro camadas (domain, application, infrastructure, interfaces/http), sete regras numeradas (as dependências apontam para dentro, núcleo sem frameworks, os contextos conversam por tipos, contratos compartilhados, regenerar a API, usar os geradores, "pronto é verde") e um ponteiro para o CLAUDE.md na versão longa. Deixa de fora as regras de design do frontend e tudo o que não caiba numa tela. Não tem arquivos aninhados por módulo. E diz com todas as letras que essas regras são impostas pelo ESLint, pelos hooks do Claude Code e pelo CI, o que só é verdade porque esses arquivos existem no mesmo 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.
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.
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
AGENTS.md ou CLAUDE.md?+
O AGENTS.md basta para manter um agente dentro da 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.