Criando e Usando Modos Personalizados no Cursor

O Cursor permite que você crie modos de agente personalizados — papéis de IA especializados adaptados a tarefas específicas, pilhas tecnológicas ou padrões de codificação. Este guia explica como construir, configurar e usar modos personalizados para máxima eficiência.

O que são Modos Personalizados?

Modos personalizados são:

• Papéis de agente especializados projetados para tarefas específicas
• Específicos à pilha tecnológica, adaptados a frameworks e linguagens
• Restrições de estilo que impõem padrões de codificação
• Configurações reutilizáveis para salvar e compartilhar entre projetos

Modos Integrados

O Cursor vem com vários modos integrados:

Modo	Uso	Casos de Uso
General	Codificação geral	Tarefas diárias
Agent	Execução autônoma	Tarefas complexas de múltiplos arquivos
Ask	Perguntas e respostas	Explicações, aprendizado
Review	Revisão de código	Verificações de qualidade

Criando um Modo Personalizado

Passo 1: Definir o propósito do modo

Determine o que seu modo fará:

Nome do modo: Especialista em Testes Frontend
Propósito: Escrever testes abrangentes para componentes React
Pilha tecnológica: React, Jest, React Testing Library
Saída: Arquivos de teste e relatórios de cobertura

Passo 2: Abrir o editor de modos

1. Vá para Configurações > Configurações do Agente > Modos
2. Clique em + Criar novo modo
3. Ou pressione Cmd/Ctrl + Shift + M

Passo 3: Configurar o modo

Informações básicas

Nome: Especialista em Testes Frontend
Descrição: Escrever testes abrangentes para componentes React
Ícone: 🧪 (opcional)
Atalho: Cmd+Shift+T (opcional)

Prompt do sistema

Esta é a personalidade orientadora do modo:

Você é um especialista em QA focado em testes frontend.

## Suas responsabilidades
- Escrever testes abrangentes para componentes React
- Implementar testes unitários e de integração
- Usar React Testing Library e Jest
- Seguir os princípios de Desenvolvimento Orientado a Testes (TDD)

## Formato de saída
1. Comentários descrevendo o propósito do teste
2. Testes cobrindo renderização, interações e casos extremos
3. Testes de snapshot para consistência de UI
4. Testes de acessibilidade para conformidade a11y
5. Relatório de cobertura após conclusão dos testes

## Padrões de codificação
- Usar blocos `describe`/`it` para todos os testes
- Seguir o padrão AAA (Arrange-Act-Assert)
- Usar o objeto `screen` para todas as interações
- Priorizar `data-testid` como seletor
- Usar constantes para todos os IDs de teste

## Requisitos de cobertura
- Ramificações: >80%
- Funções: >90%
- Linhas: >85%
- Declarações: >85%

Arquivo de regras (opcional)

Crie .cursor/rules/testing-expert.mdc:

---
description: 'Regras do especialista em testes frontend'
globs: ['**/*.test.{ts,tsx}']
alwaysApply: true
---

## Padrões de teste

### Cada componente deve testar
1. Renderização com diferentes props
2. Interações do usuário (cliques, entradas, envios)
3. Casos extremos (estados vazios, carregamento, erros)
4. Atributos de acessibilidade
5. Execução de funções de retorno de chamada

### Estrutura de teste
```typescript
describe('ComponentName', () => {
  describe('Renderização', () => {
    it('deve renderizar com props padrão', () => {});
    it('deve renderizar com props personalizadas', () => {});
  });

  describe('Interações', () => {
    it('deve lidar com o evento de clique ao clicar', () => {});
    it('deve atualizar o valor ao digitar', () => {});
  });

  describe('Casos extremos', () => {
    it('deve lidar com dados vazios', () => {});
    it('deve exibir estado de carregamento', () => {});
    it('deve exibir estado de erro', () => {});
  });
});

Limites de cobertura

• Ramificações: >80%
• Funções: >90%
• Linhas: >85%

### Passo 4: Testar o modo

Teste seu modo antes de adotá-lo:

[Especialista em Testes Frontend] Escreva testes para o componente UserProfile.

Caminho do componente: src/components/UserProfile.tsx

### Passo 5: Salvar e ativar

1. Clique em **Salvar modo**
2. Selecione-o no seletor de modos
3. Inicie a conversação

## Personalização avançada

### Modos baseados em framework

#### Modo especialista React

```markdown
## Modo especialista React

### Pilha tecnológica
- React 18+ com hooks
- TypeScript
- Tailwind CSS
- React Query para busca de dados

### Padrões de codificação
1. Usar componentes de função para todos os componentes
2. Usar interfaces TypeScript para definir props
3. Implementar React.memo para otimização
4. Usar useEffect para todos os efeitos colaterais
5. Usar hooks personalizados para lógica

### Estrutura de arquivos

src/ components/ ComponentName/ index.tsx ComponentName.tsx ComponentName.test.tsx types.ts hooks/ useComponentName.ts

### Formato de saída
1. Arquivo de componente tipado
2. Testes unitários
3. Stories do Storybook (se aplicável)
4. Comentários de documentação

Modo de desenvolvimento de API

## Modo de desenvolvimento de API

### Pilha tecnológica
- Node.js + Express
- TypeScript
- Prisma ORM
- Validação Zod

### Padrões de codificação
1. Usar esquemas Zod para validação de requisições
2. Implementar tratamento de erros apropriado para todos os endpoints
3. Usar formato consistente para todas as respostas de API
4. Implementar limitação de taxa
5. Adicionar documentação swagger para todos os endpoints

### Estrutura de arquivos

src/ routes/ entity/ index.ts entity.controller.ts entity.service.ts entity.validator.ts entity.types.ts

### Formato de saída
1. Controlador com validação
2. Camada de serviço com lógica de negócios
3. Arquivo index para definições de rotas
4. Padrão de repositório para acesso ao banco de dados

Modos com ferramentas

Modo de migração de banco de dados

## Especialista em migração de banco de dados

### Ferramentas
- Prisma Migrate
- Drizzle ORM
- TypeORM

### Fluxo de trabalho
1. Analisar o esquema atual
2. Criar arquivo de migração
3. Gerar script de rollback
4. Verificar integridade dos dados
5. Atualizar dados de seed

### Formato de saída
1. Arquivo SQL de migração
2. Script de rollback
3. Log de migração
4. Consultas de validação

Modos com restrições de verificação

Modo de auditoria de segurança

## Modo de auditoria de segurança

### Foco
- OWASP Top 10
- Validação de entrada
- Autenticação/autorização
- Proteção de dados

### Fluxo de trabalho
1. Escanear vulnerabilidades comuns
2. Identificar riscos de injeção
3. Verificar falhas de autenticação
4. Revisar exposição de dados
5. Gerar relatório de segurança

### Formato de saída
1. Lista de vulnerabilidades ordenada por gravidade
2. Arquivos afetados e localizações
3. Correções recomendadas
4. Exemplos de código
5. Casos de teste de segurança

Alternância de modos

Alternância manual

1. Clique no seletor de modos no chat
2. Selecione o modo no menu suspenso
3. Inicie sua tarefa

Alternância automática

Use regras para alternar modos automaticamente com base no tipo de arquivo:

---
description: 'Alternância automática de modo baseada em contexto'
globs: ['**/*.test.{ts,tsx}']
alwaysApply: true
---

Ao trabalhar neste contexto, alterne para o modo **Especialista em Testes Frontend**.
Siga os padrões de teste e os requisitos de cobertura.

Combinações de fluxo de trabalho

Crie fluxos de trabalho que combinam vários modos:

# Passo 1: Usar modo Arquiteto
[Arquiteto] Projete os endpoints de API para gerenciamento de usuários.

# Passo 2: Usar modo Desenvolvimento de API
[Desenvolvimento de API] Implemente os endpoints projetados na Etapa 1.

# Passo 3: Usar modo de Teste
[Especialista em Testes Frontend] Escreva testes para o cliente da API.

# Passo 4: Usar modo de Revisão
[Revisão] Revise a qualidade de todas as alterações.

Compartilhamento de modos

Exportar modo

# Exportar configuração do modo
cursor mode:export frontend-testing-expert > frontend-testing-expert.json

Importar modo

# Importar configuração do modo
cursor mode:import frontend-testing-expert.json

Compartilhamento em equipe

1. Salve os arquivos de modo em .cursor/modes/
2. Faça commit no controle de versão
3. Membros da equipe importam
4. Padronize em todos os projetos

Biblioteca de modelos de modos

Modelo 1: Revisor de código

## Especialista em revisão de código

### Foco
- Qualidade do código
- Desempenho
- Manutenibilidade
- Melhores práticas

### Critérios de revisão
1. O código segue o estilo do projeto
2. As funções são pequenas e focadas o suficiente
3. A nomenclatura de variáveis é clara
4. O tratamento de erros é apropriado
5. Não há duplicação de código
6. O desempenho é otimizado

### Formato de saída
1. Pontuação geral de qualidade
2. Problemas específicos com números de linha
3. Sugestões de melhoria
4. Exemplos de refatoração
5. Feedback positivo

Modelo 2: Escritor de documentação

## Escritor de documentação técnica

### Foco
- Documentação de API
- Arquivos README
- Comentários de código
- Guias de uso

### Padrões
1. Todas as APIs públicas estão documentadas
2. O README contém instruções de configuração
3. O código tem comentários inline
4. Exemplos são fornecidos
5. Um changelog é mantido

### Formato de saída
1. Documentos Markdown com exemplos
2. Comentários JSDoc/TypeDoc
3. Seções README
4. Entradas de changelog
5. Guias de uso

Modelo 3: Otimizador de desempenho

## Especialista em otimização de desempenho

### Foco
- Desempenho em tempo de execução
- Uso de memória
- Otimização de build
- Eficiência de rede

### Análise
1. Identificar gargalos
2. Analisar uso de memória
3. Revisar saída de build
4. Verificar requisições de rede
5. Medir tempos de carregamento

### Otimizações
1. Divisão de código
2. Carregamento lento
3. Estratégias de cache
4. Compressão de recursos
5. Otimização de consultas

### Formato de saída
1. Linha de base de desempenho
2. Análise de gargalos
3. Sugestões de otimização
4. Plano de implementação
5. Resultados de medição

Melhores práticas

Design de modo

1. Específico: Focar em um único propósito
2. Restrito: Definir limites claros
3. Testável: Incluir critérios de validação
4. Documentado: Explicar o processo de decisão

Engenharia de prompt

## Estrutura de prompt de modo eficaz

### Definição de papel
- Quem você é
- Sua expertise
- Suas restrições

### Fluxo de trabalho
- Os passos que você segue
- Pontos de decisão
- Critérios de qualidade

### Formato de saída
- Estrutura de resposta
- O que está incluído
- Convenções usadas

### Restrições
- O que você deve fazer
- O que você nunca deve fazer
- Padrões de qualidade

Recursos relacionados

• Cursor Agent Mode Masterclass
• RIPER-5 Advanced Constraint Mode
• Plan vs Act Dual-Mode Workflow