Para devs AI-native / CODEX
Un boilerplate SaaS
que Codex lee desde el primer prompt
Codex toma las reglas del proyecto de AGENTS.md. useDeploy trae uno y lo respalda con lint y CI, porque en este repo Codex no tiene hooks.
Cómo carga Codex tus reglas
Según la guía oficial de AGENTS.md (https://learn.chatgpt.com/docs/agent-configuration/agents-md), Codex arma sus instrucciones cuando empieza una corrida. Primero mira tu Codex home (~/.codex por defecto) y usa solo el primer archivo no vacío de ahí, AGENTS.override.md antes que AGENTS.md. Después arranca en la raíz del proyecto y baja hacia el directorio actual, incluyendo como máximo un archivo por directorio. Los archivos se combinan de la raíz hacia abajo, así que los más cercanos a tu directorio de trabajo pisan la guía anterior. La carga se corta cuando el tamaño combinado llega a project_doc_max_bytes, 32 KiB por defecto. El AGENTS.md de la raíz de useDeploy tiene unas 40 líneas, muy por debajo.
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 Codex
No hay carpeta .codex ni configuración específica de Codex; AGENTS.md es toda la integración. Los hooks de .claude son solo de Claude Code y no corren en Codex. Eso deja al lint y al CI como el cumplimiento en una sesión de Codex: AGENTS.md le pide al agente correr bun run guardrails antes de terminar, pero nada lo obliga. Tampoco incluimos AGENTS.md anidados por módulo; el de la raíz cubre el 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.
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
¿Necesito un archivo específico de Codex?+
¿Sirve el setup de hooks de Claude Code con Codex?+
¿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.