Para devs AI-native / GITHUB COPILOT
Um boilerplate SaaS
para o Copilot, via AGENTS.md
O Copilot lê as instruções do repositório em três tipos de arquivo. O useDeploy traz um, o AGENTS.md, e deixa os outros dois para você adicionar se quiser.
Como o GitHub Copilot carrega suas regras
Segundo a documentação oficial (https://docs.github.com/en/copilot/how-tos/configure-custom-instructions/add-repository-instructions), o Copilot lê três tipos de arquivos de instruções do repositório. As instruções para todo o repositório ficam em .github/copilot-instructions.md. As instruções por caminho ficam em arquivos com o sufixo .instructions.md dentro de .github/instructions, cada um com um glob applyTo (no GitHub.com isso hoje funciona para o cloud agent e a revisão de código). As instruções de agente ficam no AGENTS.md: você pode criar um ou vários, em qualquer lugar do repositório, e vence o mais próximo na árvore de diretórios.
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 Copilot
Não há .github/copilot-instructions.md nem arquivos .instructions.md por caminho. Os agentes do Copilot (cloud agent, CLI, Chat no VS Code) ficam cobertos pelo AGENTS.md da raiz; o Chat no GitHub.com, no Visual Studio e no JetBrains não o leem. Para cobri-los, crie .github/copilot-instructions.md com uma linha mandando seguir as regras do AGENTS.md. Os hooks do Claude Code não rodam no Copilot. A imposição são as regras de camadas do ESLint e os jobs de CI, que também filtram os pull requests escritos pelo Copilot.
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.
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 GitHub Copilot lê o AGENTS.md?+
Ainda devo adicionar o .github/copilot-instructions.md?+
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.