Saltar al contenido
Empezar un proyectoEmpezar

AGENTS.md

El mapa y las reglas de la casa, en la raíz del proyecto. Tu agente lo lee antes de cambiar el código.

Qué contiene

  • El mapa: cada app y cada paquete, y qué va en cada lugar.
  • Los comandos: pnpm dev, pnpm db:local, pnpm test y los demás, con lo que hace cada uno.
  • Las reglas: dónde va el código, cómo se renderizan las páginas, cómo funcionan los datos y los ID, la autenticación y los permisos, los textos y los idiomas, las variables de entorno, el estilo.
  • Solución de problemas: los pocos errores con los que se topa la gente, y cómo arreglarlos.
  • Los skills: qué receta usar para cada cambio.

Las reglas, una muestra

### Where code goes

- Queries on app tables live in packages/api/src/services. Server actions,
  REST routes and MCP tools all call the services; none of them query the
  database themselves.
- A new API endpoint is an operation: skill add-operation. It gives the
  REST route, the MCP tool and the OpenAPI entry together.
- A new table: skill add-table. A new page: skill add-page.

Una regla cierra cada cambio: antes de decir que terminó, el agente ejecuta pnpm lint, pnpm typecheck y pnpm test, y corrige lo que reportan.

Un archivo para todos los agentes

CLAUDE.md contiene una línea, @AGENTS.md, así que Claude Code lee las mismas reglas que Codex y Cursor. La app web tiene su propio apps/web/AGENTS.md para las reglas que solo valen ahí.

Ejecuta un comando. La CLI pregunta lo demás, y tu agente sigue desde ahí.

pnpm create turbinekit my-app
Ver el prompt

Pégalo en un agente que pueda ejecutar comandos, como Claude Code, Codex o Cursor. El prompt está en inglés.

Create a new TurbineKit project with me.
Talk to me in Spanish.

TurbineKit (https://turbinekit.dev) is an open-source Turborepo and Next.js starter. Its CLI, create-turbinekit, needs Node.js 24 and pnpm 10 (run `corepack enable` once).

1. Run `pnpm dlx create-turbinekit --help` to see its options.
2. Ask me its questions one at a time, with their defaults: the folder, the product name, one sentence about the product, the company or legal name, the contact email, the languages and the modules. Skip what I have already told you.
3. The CLI only asks questions in an interactive terminal, so run it with my answers as options and `--yes`. Show me the command before you run it.
4. In the new folder, read AGENTS.md. Then do "1. Minimal setup" in SETUP.md, and tick each box you finish.
5. Tell me the URL of the running app, and which services SETUP.md lists next.

Sin registro, sin claves de API. Necesita Node.js 24 y pnpm 10.