Para devs AI-native / AGENTS.MD
AGENTS.md para un SaaS,
y lo que no puede hacer cumplir
Un archivo corto que leen varios agentes de código. useDeploy trae uno real, de 40 líneas, atado a las reglas de lint que lo convierten en algo más que una sugerencia.
Qué es AGENTS.md y quién lo lee
Según agents.md (https://agents.md), AGENTS.md es un archivo abierto, basado en Markdown, que le da contexto del proyecto a los agentes de código: "un README para agentes". El sitio lista como compatibles a Codex, Cursor, el coding agent de GitHub Copilot, Windsurf, Gemini CLI, Jules, Zed, Warp, Devin y otros. En monorepos podés poner uno en cada subproyecto; los agentes leen el archivo más cercano en el árbol de directorios, así que gana el más próximo, y los prompts explícitos del usuario en el chat pisan todo. Claude Code también puede leerlo, en lugar de CLAUDE.md. Sigue siendo un archivo de texto: el agente puede ignorarlo.
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. |
| 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. |
| 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. |
| .cursor/rules/architecture.mdc | Regla de Cursor acotada a los módulos del server (reglas de capas, apunta a AGENTS.md). | Solo Cursor. Una regla es contexto, no un bloqueo. |
Qué contiene un AGENTS.md real acá, y qué deja afuera
El AGENTS.md de useDeploy tiene el layout del server como una tabla de cuatro capas (domain, application, infrastructure, interfaces/http), siete reglas numeradas (las dependencias apuntan hacia adentro, núcleo sin frameworks, los contextos se hablan por tipos, contratos compartidos, regenerar la API, usar los generadores, "terminado es verde") y un puntero a CLAUDE.md para la versión larga. Deja afuera las reglas de diseño del frontend y todo lo que no entre en una pantalla. No tiene archivos anidados por módulo. Y dice sin vueltas que esas reglas las hacen cumplir ESLint, los hooks de Claude Code y el CI, cosa que solo es cierta porque esos archivos existen en el mismo repo.
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.
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.
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
¿AGENTS.md o CLAUDE.md?+
¿Alcanza AGENTS.md para mantener a un agente dentro de 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.