Cursor em Profundidade — Composer 2, Agentes e Cloud
Baixar PDFGuia completo do Cursor IDE: Composer 2 com planning, agentes autônomos, cloud agents, @-mentions, rules, configuração avançada e comparação com Claude Code.
Cursor evoluiu de "autocomplete com IA" para uma IDE agêntica completa. O Composer 2 executa planos autonomamente, cria branches, abre PRs e trabalha em background via cloud agents.
Composer 2 — O agente do Cursor
Fluxo Plan → Build
- Escreva o PRD —
feature-prd.mdcom requisitos detalhados - Abra Composer —
Cmd+K(inline) ou painel lateral - Referencie arquivos —
@specs/auth.md @src/db/schema.ts - Peça o plano — Composer gera task list do PRD
- Revise o plano — edite, reordene, remova tarefas
- Execute — Composer implementa autonomamente
- Revise diffs — aceite/rejeite cada alteração
Prompt efetivo no Composer
@specs/billing.md @src/models/user.ts @src/db/schema.ts
Implement the billing module from @specs/billing.md.
Requirements:
- Follow the existing model patterns in @src/models/user.ts
- Use the schema from @src/db/schema.ts
- Write Vitest tests for each endpoint BEFORE implementing
- 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.Cloud Agents
Cloud agents rodam em máquinas da Cursor — você pode fechar o laptop e voltar depois.
Como usar
- Abra Composer com uma tarefa grande
- Clique em "Run in Cloud"
- Cursor cria uma branch, abre máquina, executa
- Você recebe notificação quando terminar
- Review do PR no GitHub ou dentro do Cursor
Quando usar cloud agents
| Cenário | Use cloud? |
|---|---|
| Corrigir um lint | Não — faça local |
| Implementar módulo inteiro | Sim — 30+ min de trabalho |
| Refatorar 20 arquivos | Sim — paralelizável |
| Debug de erro específico | Não — precisa do seu ambiente |
| Gerar testes para módulo | Sim — trabalho repetitivo |
@-mentions no Cursor
| Sintax | O que inclui |
|---|---|
@file | Conteúdo de um arquivo |
@folder | Todos os arquivos de uma pasta |
@code | Trecho selecionado |
@git | Diff do git (changes, branch, log) |
@web | Resultado de busca na web |
@docs | Documentação de bibliotecas |
@terminal | Output do terminal |
Exemplo prático
@file specs/auth.md @file src/api/users.ts @git diff
Review the changes in @git diff against the spec in @file specs/auth.md.
Does the implementation match the spec? List any deviations.Rules do Cursor
Cursor tem seu próprio sistema de rules (similar ao CLAUDE.md):
.cursorrules (raiz do projeto)
# Cursor Rules
## Stack
TypeScript, Next.js 16, React 19, Tailwind CSS v4
## Conventions
- 2-space indent, single quotes
- Components in PascalCase
- Always use <Link> for internal navigation
- Always use Vitest (never Jest)
## Code Style
- Prefer functional components
- Use TypeScript strict mode
- No `any` types — use `unknown` instead
- Always handle errors explicitlyRules por diretório
.cursor/
├── rules/
│ ├── backend.md # Regras para Go
│ ├── frontend.md # Regras para React
│ └── tests.md # Regras para testesComparação: Cursor vs Claude Code
| Aspecto | Cursor | Claude Code |
|---|---|---|
| Interface | IDE visual (VS Code fork) | Terminal / CLI |
| Autocomplete | Inline (Tab) | Não tem (foco em agente) |
| Agente | Composer 2 | claude CLI |
| Cloud | Cloud agents built-in | claude --cloud |
| Git | Integrado na IDE | Via comandos shell |
| Subagentes | Cloud agents paralelos | Subagents no terminal |
| Pricing | $20/mês (Pro) + usage | Usage-based (API) |
| Melhor para | Coding assistido no dia a dia | Tarefas agênticas complexas |
Quando usar qual
- Cursor: dia a dia no editor, autocomplete, refatoração assistida, Composer para features
- Claude Code: tarefas complexas no terminal, pipes de dados, scripts automatizados, cloud agents para work longo
- Ambos: Cursor para escrever + Claude Code para rodar no terminal em paralelo
Erros comuns com Cursor
| Erro | Consequência | Correção |
|---|---|---|
| Composer sem @-mentions | Cursor "adivinha" o contexto errado | Sempre referencie arquivos relevantes |
| Aceitar diffs sem revisar | Bugs em produção | Revise CADA diff |
| Cloud agent sem spec | Resultado vago | PRD antes de cloud |
| Não atualizar .cursorrules | Regras obsoletas | Versionar e revisar mensalmente |
Claude Code em Profundidade — Do Terminal à Produção
Guia completo do Claude Code: terminal, IDE, desktop, cloud agents. Configuração avançada, slash commands, Plan-Then-Execute e padrões de uso real.
Automação com Hooks, Rules e Skills — Gatilhos no Workflow de IA
Como funcionam hooks, rules, skills e triggers no Claude Code e Cursor. Configuração prática, exemplos reais e como automatizar back-pressure no ciclo de desenvolvimento.