Pular para o conteúdo
Começar um projetoComeçar

AGENTS.md

O mapa e as regras da casa, na raiz do projeto. O seu agente lê esse arquivo antes de mudar o código.

O que tem nele

  • O mapa: cada app e cada pacote, e o que vai onde.
  • Os comandos: pnpm dev, pnpm db:local, pnpm test e os outros, com o que cada um faz.
  • As regras: onde fica o código, como as páginas são renderizadas, como funcionam os dados e os IDs, autenticação e permissões, textos e idiomas, variáveis de ambiente, estilo.
  • Solução de problemas: os poucos erros que as pessoas encontram, e como corrigir cada um.
  • Os skills: qual receita usar para cada mudança.

As regras, um trecho

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

Uma regra fecha toda mudança: antes de dizer que terminou, o agente roda pnpm lint, pnpm typecheck e pnpm test, e corrige o que eles apontam.

Um arquivo para todos os agentes

O CLAUDE.md tem uma linha, @AGENTS.md, então o Claude Code lê as mesmas regras que o Codex e o Cursor. O app web tem um apps/web/AGENTS.md próprio, para as regras que só valem nele.

Rode um comando. A CLI pergunta o resto, e o seu agente continua daí.

pnpm create turbinekit my-app
Ver o prompt

Cole em um agente que possa rodar comandos, como Claude Code, Codex ou Cursor. O prompt está em inglês.

Create a new TurbineKit project with me.
Talk to me in Brazilian Portuguese.

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.

Sem cadastro, sem chaves de API. Precisa de Node.js 24 e pnpm 10.