Para devs AI-native / CLAUDE CODE
Un boilerplate SaaS
donde Claude Code puede trabajar
CLAUDE.md le dice las reglas a Claude Code. Los hooks, ESLint y el CI hacen que las cumpla. Acá van los archivos exactos que trae useDeploy para cada cosa, y dónde termina la garantía.
Cómo carga Claude Code tus reglas
Según la doc oficial de memoria (https://code.claude.com/docs/en/memory), Claude Code lee CLAUDE.md al empezar cada sesión, desde ./CLAUDE.md o ./.claude/CLAUDE.md, y también puede leer el AGENTS.md del repo en lugar de CLAUDE.md. La misma página es explícita con el límite: Claude trata CLAUDE.md como contexto, no como configuración forzada, y para bloquear una acción pase lo que pase se usa un hook PreToolUse. Las reglas en un archivo son un pedido. El cumplimiento vive en hooks, lint y CI.
Qué trae useDeploy hoy, archivo por archivo
| Archivo en el repo | Qué hace | Quién lo hace cumplir |
|---|---|---|
| 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. |
| 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. |
| .claude/settings.json | Registra los dos hooks de Claude Code (PostToolUse y Stop). | Solo Claude Code. |
| .claude/hooks/lint-edited-file.mjs | Hook PostToolUse: lintea cada archivo que el agente acaba de editar y le devuelve el reporte de ESLint en el mismo turno. | Solo Claude Code. Avisa después de la edición; no la bloquea. |
| .claude/hooks/verify-before-stop.mjs | Hook Stop: si el agente intenta terminar y bun run guardrails falla, lo manda de vuelta una vez con el error. | Solo Claude Code. Un reintento forzado, no una garantía. |
| 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. |
Lo que useDeploy no trae para Claude Code
No hay hook PreToolUse: nada frena una edición antes de que ocurra. El hook de lint avisa justo después de la edición y el hook Stop fuerza un solo reintento, así que un error que el agente no sabe arreglar llega hasta el CI, que es la compuerta real. Tampoco traemos una biblioteca de skills de proyecto para el SaaS en sí (la carpeta .claude tiene los hooks, un subagente code-smell y algunas skills de integración con WhatsApp). Si querés un bloqueo con PreToolUse, el kit es el lugar para extenderlo.
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
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.
Windsurf
Cómo carga Windsurf 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
¿Claude Code necesita CLAUDE.md o puede usar AGENTS.md?+
¿Los hooks garantizan que el agente no rompa la arquitectura?+
¿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.