Cursor: Extraindo 100% — Guia Definitivo para Full Stack Developers

1. Escreva o PRD (feature-prd.md)
2. Abra Composer (Cmd+I)
3. Referencie arquivos com @
4. Peça o plano → Composer gera task list
5. Revise o plano (edite, reordene, remova)
6. Execute → Composer implementa autonomamente
7. Revise diffs (aceite/rejeite cada alteração)

@file specs/billing.md @file src/api/users.ts @file src/db/schema.ts

Implement the billing module from @file specs/billing.md.

Requirements:
- Follow patterns from @file src/api/users.ts
- Use schema from @file src/db/schema.ts
- Write Vitest tests BEFORE implementing each endpoint
- After implementing, run: pnpm lint:fix && pnpm vitest run
- If any test fails, fix until all pass

Create a plan first, then execute one task at a time.

1. Abra Composer com tarefa grande
2. Clique "Run in Cloud"
3. Cursor cria branch, abre máquina, executa
4. Você recebe notificação quando terminar
5. Review do PR no GitHub ou dentro do Cursor

@file specs/auth.md @git diff

Review the changes in @git diff against the spec.
Does the implementation match? List deviations.

@folder src/api/ @file src/db/schema.ts

Analyze all API routes in @folder src/api/.
Check if they follow the schema in @file src/db/schema.ts.
Find N+1 queries, missing validations, and exposed internals.

@problems @file src/components/Dashboard.tsx

Fix all TypeScript errors shown in @problems for Dashboard.tsx.

# Antigo (deprecated)
.cursorrules

# Novo (recomendado)
.cursor/rules/global.md
.cursor/rules/backend.md
.cursor/rules/frontend.md
.cursor/rules/tests.md

---
description: "TypeScript and React conventions"
globs: ["**/*.ts", "**/*.tsx"]
alwaysApply: true
---

## Stack
TypeScript strict, React 19, Next.js 16, Tailwind CSS v4

## Conventions
- 2-space indent, single quotes, trailing commas
- Components in PascalCase, files in kebab-case
- Always use <Link> for internal navigation
- Vitest only (never Jest)
- No `any` types — use `unknown`

## After every change
1. pnpm lint:fix
2. pnpm format
3. pnpm vitest run

---
# Compatível com Cursor, Claude Code e OpenCode
paths:         # Claude Code e OpenCode
  - "backend/**/*.go"
globs:         # Cursor
  - "backend/**/*.go"
alwaysApply: false
---
## Go Conventions
- Go 1.23, Gin framework
- Table-driven tests
- Error handling: fmt.Errorf("contexto: %w", err)

# Composer para implementação complexa → Claude Opus 4.7
# Tab autocomplete → Claude Sonnet 4 (rápido, barato)
# Chat para debug → GPT-4o (bom em explicar)
# Cloud agent → Claude Opus 4.7 (melhor qualidade)

Cursor Settings → Models → API Key → Add
Use sua chave Anthropic/OpenAI/Google diretamente.

@problems @file src/api/users.ts @terminal

The test is failing with:
@terminal output from: pnpm vitest run src/__tests__/users.test.ts

Read the error, find the root cause in @file src/api/users.ts,
and fix it. Don't weaken the test.

@terminal @file src/workers/processor.ts

The worker crashed with this log:
[paste log here]

Find the root cause in @file src/workers/processor.ts
and fix it. Write a test that reproduces the crash.

@git diff main

Review this diff against our conventions in .cursor/rules/global.md.
Check for:
1. Security issues
2. Missing tests
3. Type safety violations
4. Performance concerns

For each issue: FILE:LINE — description — severity

@git diff --cached

Analyze these staged changes and generate a Conventional Commit message.
Subject ≤ 50 chars. Body only when "why" isn't obvious.

# 1. Instalar Cursor
# Download de https://cursor.com

# 2. Configurar models
# Cursor Settings → Models → adicionar API keys

# 3. Criar rules
mkdir -p .cursor/rules
cat > .cursor/rules/global.md << 'EOF'
---
alwaysApply: true
---
2-space indent, single quotes.
Vitest only. Conventional Commits.
EOF

# 4. Rules por stack
# (criar backend.md, frontend.md, tests.md)

# 5. MCP (opcional)
# Cursor Settings → MCP → Add Server

# 6. Testar
# Cmd+I → "Read .cursor/rules/global.md and summarize the project"