Para devs AI-native / GITHUB COPILOT
Un boilerplate SaaS
para Copilot, vía AGENTS.md
Copilot lee las instrucciones del repo desde tres tipos de archivo. useDeploy trae uno, AGENTS.md, y deja los otros dos para que los agregues si los querés.
Cómo carga GitHub Copilot tus reglas
Según la doc oficial (https://docs.github.com/en/copilot/how-tos/configure-custom-instructions/add-repository-instructions), Copilot lee tres tipos de archivos de instrucciones del repo. Las instrucciones para todo el repo van en .github/copilot-instructions.md. Las instrucciones por ruta van en archivos con el sufijo .instructions.md dentro de .github/instructions, cada uno con un glob applyTo (en GitHub.com eso hoy funciona para el cloud agent y el code review). Las instrucciones de agente van en AGENTS.md: podés crear uno o varios, en cualquier lugar del repo, y gana el más cercano en el árbol de directorios.
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 Copilot
No hay .github/copilot-instructions.md ni archivos .instructions.md por ruta. Los agentes de Copilot (cloud agent, CLI, Chat en VS Code) quedan cubiertos por el AGENTS.md de la raíz; el Chat en GitHub.com, Visual Studio y JetBrains no lo leen. Para cubrirlos, creá .github/copilot-instructions.md con una línea que diga que siga las reglas de AGENTS.md. Los hooks de Claude Code no corren en Copilot. El cumplimiento son las reglas de capas de ESLint y los jobs de CI, que también filtran los pull requests escritos por Copilot.
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.
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
¿GitHub Copilot lee AGENTS.md?+
¿Igual debería agregar .github/copilot-instructions.md?+
¿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.