Para devs AI-native / WINDSURF
Un boilerplate SaaS
para Windsurf, sin archivo de reglas aparte
useDeploy no tiene un archivo específico de Windsurf. Se apoya en el AGENTS.md de la raíz, respaldado por lint y CI. Acá va lo que dice la doc sobre eso, y qué agregar si tu setup lo necesita.
Cómo carga Windsurf tus reglas
La página de AGENTS.md de la doc de Windsurf (https://docs.windsurf.com/windsurf/cascade/agents-md) ahora redirige a la doc de Devin; ahí se describe que los AGENTS.md se leen como reglas siempre activas, y que los archivos legacy .windsurf/rules, global_rules.md y .windsurfrules se importan por defecto. El sitio agents.md también lista a Windsurf entre las herramientas que soportan AGENTS.md. No probamos cada build de Windsurf contra este repo, así que verificá que tu versión levante el AGENTS.md de la raíz. El resto de la evidencia es documentación, no una prueba nuestra.
Qué trae useDeploy hoy, archivo por archivo
| Archivo en el repo | Qué hace | Quién lo hace cumplir |
|---|---|---|
| AGENTS.md | Reglas cortas de arquitectura: capas, contratos, "terminado es verde". Las recibe cualquier agente que lea AGENTS.md. | Contexto que lee el agente. Las reglas que enuncia están respaldadas por las reglas de capas de ESLint. |
| packages/eslint-config/ddd.js | Reglas de capas de ESLint: domain y application no pueden importar express, Prisma ni BetterAuth; los contextos se hablan por tipos. | Cualquier herramienta, cualquier editor. Esto es lo que el agente no puede esquivar con palabras. |
| .github/workflows/ci.yml | Los jobs de lint y typecheck corren en cada pull request (el de tests también). | Cualquier herramienta. Es la compuerta compartida. |
| CLAUDE.md | Manual de operación largo: capas DDD, contratos, regeneración de la API, reglas de docs, sistema de diseño. | Solo contexto. Claude Code lo lee al empezar la sesión. |
Lo que useDeploy no trae para Windsurf
No hay .windsurfrules ni carpeta .windsurf/rules. El camino que tomamos es apuntar a Windsurf al AGENTS.md en vez de mantener una segunda copia de las reglas. Si tu build no lo lee, agregá un archivo de reglas en .windsurf/rules (ruta legacy, todavía se importa) que diga que se siga el AGENTS.md de la raíz. Los hooks de Claude Code no corren en Windsurf, así que ahí el cumplimiento es lint más CI, con el agente instruido en AGENTS.md a correr bun run guardrails.
Comparación honesta: los otros también traen archivos para agentes
useDeploy es nuestro producto, así que tomalo con ese sesgo. MakerKit, supastarter, Nextbase, ShipAny e Indie Kit también traen un AGENTS.md, archivos de reglas o skills de agentes para herramientas de IA, y AnotherWrapper vende un harness de hooks bloqueantes ("Hooks, not instructions"). Lo que useDeploy suma sobre AGENTS.md es la combinación de reglas de capas de ESLint, hooks de Claude Code y una compuerta de CI en el mismo repo. No es el único kit con archivos para agentes, y un archivo de reglas solo, nuestro o de cualquiera, es apenas un pedido.
El kit open source y las guías
Llevate los guardrails sin el boilerplate
Los hooks y el settings están publicados como kit MIT: https://github.com/KonixDev/claude-code-guardrails. Metelo en cualquier repo que tenga config de ESLint y un script guardrails.
Escribí los archivos vos
Guías (en inglés): /blog/claude-md-file-example-saas (CLAUDE.md), /blog/claude-code-hooks-enforce-architecture (hooks), /blog/cursor-rules-nextjs-typescript (reglas de Cursor), /blog/claude-code-skills-subagents-architecture-review (skills y subagentes).
Compará los kits
Ranking por caso de uso (en inglés), con los casos donde conviene otro kit.
Otras herramientas de IA
Claude Code
Cómo carga Claude Code sus reglas y qué cubre useDeploy para esa herramienta.
Cursor
Cómo carga Cursor sus reglas y qué cubre useDeploy para esa herramienta.
OpenAI Codex
Cómo carga OpenAI Codex sus reglas y qué cubre useDeploy para esa herramienta.
GitHub Copilot
Cómo carga GitHub Copilot sus reglas y qué cubre useDeploy para esa herramienta.
AGENTS.md
Cómo carga AGENTS.md sus reglas y qué cubre useDeploy para esa herramienta.
Agentes de código con IA: el panorama
La vista general de los guardrails que comparten todas las herramientas de IA: reglas de capas, contratos tipados y el gate de CI.
Preguntas frecuentes
¿Windsurf lee AGENTS.md?+
¿Por qué no traen un .windsurfrules?+
¿Cuánto cuesta useDeploy?+
| Precio | Founder $99 o Lifetime $199, pago único (sin suscripción) |
|---|---|
| Licencia | Código fuente completo, uso comercial, proyectos ilimitados. Founder es una versión congelada; Lifetime incluye todas las versiones futuras. |
| Stack | Frontend en Next.js, API en Express, runtime Bun, Prisma, BetterAuth |
| Autenticación | BetterAuth: sesiones, 2FA, magic links, reseteo de contraseña |
| Multi-tenancy y RBAC | Organizaciones con miembros, invitaciones, roles y permisos |
| Pagos | Polar: facturación completa (checkout, portal de cliente, webhooks, sincronización de planes). MercadoPago: pagos únicos con Checkout Pro y webhooks firmados; las suscripciones todavía no están soportadas. Stripe: scaffold de adapter, todavía no cobra. |
| Guardrails para agentes de IA | Capas de arquitectura forzadas con ESLint, hooks de Claude Code y un AGENTS.md |
| Reembolso | 14 días |
| Probalo: cuenta gratis | Registrate gratis y explorá el dashboard: organizaciones, roles, facturación, registro de auditoría. La licencia se compra desde adentro. https://usedeploy.dev/register |
| Docs | Documentación en inglés, con traducciones al español y al portugués de las guías principales |
Reglas que el agente lee, paredes que no puede cruzar.
Arrancá desde una base donde la arquitectura la hacen cumplir el lint y el CI, y los archivos para agentes ya están escritos.