Para devs AI-native / WINDSURF
Um boilerplate SaaS
para o Windsurf, sem arquivo de regras à parte
O useDeploy não tem um arquivo específico do Windsurf. Ele se apoia no AGENTS.md da raiz, sustentado por lint e CI. Aqui está o que a documentação diz sobre isso, e o que adicionar se o seu setup precisar.
Como o Windsurf carrega suas regras
A página de AGENTS.md da documentação do Windsurf (https://docs.windsurf.com/windsurf/cascade/agents-md) agora redireciona para a documentação do Devin; lá, os AGENTS.md são descritos como lidos como regras sempre ativas, e os arquivos legados .windsurf/rules, global_rules.md e .windsurfrules são importados por padrão. O site agents.md também lista o Windsurf entre as ferramentas que suportam o AGENTS.md. Não testamos cada build do Windsurf contra este repositório, então confirme que a sua versão carrega o AGENTS.md da raiz. O resto da evidência é documentação, não um teste nosso.
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 Windsurf
Não há .windsurfrules nem pasta .windsurf/rules. O caminho que seguimos é apontar o Windsurf para o AGENTS.md em vez de manter uma segunda cópia das regras. Se a sua build não o lê, adicione um arquivo de regras em .windsurf/rules (caminho legado, ainda importado) dizendo para seguir o AGENTS.md da raiz. Os hooks do Claude Code não rodam no Windsurf, então lá a imposição é lint mais CI, com o agente instruído no AGENTS.md a rodar bun run guardrails.
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.
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 Windsurf lê o AGENTS.md?+
Por que não trazer um .windsurfrules?+
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.