Zum Inhalt springen
Projekt startenStarten

AGENTS.md

Die Karte und die Hausregeln, im Root des Projekts. Dein Agent liest sie, bevor er Code ändert.

Was drinsteht

  • Die Karte: jede App und jedes Package, und was wohin gehört.
  • Die Befehle: pnpm dev, pnpm db:local, pnpm test und die anderen, mit dem, was jeder davon tut.
  • Die Regeln: wohin Code gehört, wie Seiten rendern, wie Daten und IDs funktionieren, Auth und Rechte, Texte und Sprachen, Umgebungsvariablen, Stil.
  • Fehlerbehebung: die wenigen Fehler, auf die man stößt, und ihre Lösung.
  • Die Skills: welches Rezept für welche Änderung.

Die Regeln, ein Auszug

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

Eine Regel schließt jede Änderung ab: Bevor der Agent sagt, dass er fertig ist, führt er pnpm lint, pnpm typecheck und pnpm test aus und behebt, was sie melden.

Eine Datei für jeden Agent

CLAUDE.md enthält eine Zeile, @AGENTS.md, also liest Claude Code dieselben Regeln wie Codex und Cursor. Die Web-App hat ihre eigene apps/web/AGENTS.md für die Regeln, die nur dort gelten.

Starte einen Befehl. Die CLI fragt den Rest, und dein Agent macht von dort aus weiter.

pnpm create turbinekit my-app
Prompt ansehen

Füge ihn in einen Agent ein, der Befehle ausführen kann, etwa Claude Code, Codex oder Cursor. Der Prompt ist auf Englisch.

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

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.

Keine Anmeldung, keine API-Keys. Braucht Node.js 24 und pnpm 10.