Aller au contenu
Démarrer un projetDémarrer

AGENTS.md

La carte et les règles de la maison, à la racine du projet. Votre agent le lit avant de modifier le code.

Ce qu’il contient

  • La carte : chaque app et chaque package, et ce qui va où.
  • Les commandes : pnpm dev, pnpm db:local, pnpm test et les autres, avec ce que fait chacune.
  • Les règles : où va le code, comment les pages s’affichent, comment fonctionnent les données et les ID, l’authentification et les permissions, les textes et les langues, les variables d’environnement, le style.
  • Le dépannage : les quelques erreurs courantes, et leur solution.
  • Les skills : quelle recette suivre pour quel changement.

Les règles, un extrait

### 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.

Une règle conclut chaque changement : avant de dire qu’il a fini, l’agent lance pnpm lint, pnpm typecheck et pnpm test, et corrige ce qu’ils signalent.

Un fichier pour tous les agents

CLAUDE.md contient une ligne, @AGENTS.md, pour que Claude Code lise les mêmes règles que Codex et Cursor. L’app web a son propre apps/web/AGENTS.md pour les règles qui ne valent que pour elle.

Lancez une commande. La CLI pose les autres questions, et votre agent prend la suite.

pnpm create turbinekit my-app
Voir le prompt

Collez-le dans un agent qui peut lancer des commandes, comme Claude Code, Codex ou Cursor. Le prompt est en anglais.

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

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.

Sans inscription, sans clé d'API. Il faut Node.js 24 et pnpm 10.