Skip to main content

Cursor Commands – Automação e Produtividade no Dia a Dia

· 6 min read
Bruno Carneiro
Bruno Carneiro
Fundador da @TautornTech

Enquanto Rules definem padrões e Agents executam tarefas complexas, Commands (Comandos) são workflows reutilizáveis que padronizam processos comuns. Eles transformam tarefas repetitivas em comandos simples com o prefixo /.

O que são Cursor Commands?​

Commands são arquivos Markdown que definem workflows reutilizáveis. Ao digitar / no chat, você vê todos os comandos disponíveis e pode executá-los com contexto adicional.

Eles são perfeitos para:

  • Checklists padronizados: Code review, security audit
  • Workflows de desenvolvimento: Setup de features, criação de PRs
  • Processos de qualidade: Testes, validações
  • Onboarding: Configuração de ambiente

Onde Commands são Armazenados?​

Commands podem estar em três locais:

1. Project Commands​

Armazenados em .cursor/commands/ do projeto. Específicos para o projeto e versionados com Git.

2. Global Commands​

Armazenados em ~/.cursor/commands/ no seu diretório home. Disponíveis em todos os projetos.

3. Team Commands​

Criados por admins no Cursor Dashboard. Disponíveis automaticamente para todos os membros do time (planos Team e Enterprise).

Estrutura de um Command​

Commands são simples arquivos Markdown:

.cursor/commands/
├── code-review.md
├── create-pr.md
├── security-audit.md
└── setup-feature.md

Exemplo Básico​

# Code Review Checklist

## Overview
Checklist completo para revisão de código garantindo qualidade, segurança e manutenibilidade.

## Review Categories

### Functionality
- [ ] Código faz o que deveria fazer
- [ ] Casos extremos são tratados
- [ ] Tratamento de erros apropriado
- [ ] Sem bugs óbvios

### Code Quality
- [ ] Código é legível e bem estruturado
- [ ] Funções são pequenas e focadas
- [ ] Nomes de variáveis são descritivos
- [ ] Sem duplicação de código
- [ ] Segue convenções do projeto

Exemplos Práticos​

1. Code Review Checklist​

# Code Review Checklist

## Overview
Checklist abrangente para revisão de código.

## Categorias

### Funcionalidade
- [ ] Código funciona como esperado
- [ ] Edge cases tratados
- [ ] Error handling adequado
- [ ] Sem bugs óbvios

### Qualidade
- [ ] Código legível
- [ ] Funções pequenas e focadas
- [ ] Nomes descritivos
- [ ] Sem duplicação
- [ ] Segue padrões do projeto

### Segurança
- [ ] Sem vulnerabilidades óbvias
- [ ] Validação de inputs
- [ ] Dados sensíveis protegidos
- [ ] Sem secrets hardcoded

Uso:

/code-review Revise o PR #123 focando em segurança

2. Security Audit​

# Security Audit

## Overview
Revisão de segurança para identificar e corrigir vulnerabilidades.

## Passos

1. **Auditoria de dependências**
   - Verificar vulnerabilidades conhecidas
   - Atualizar pacotes desatualizados
   - Revisar dependências de terceiros

2. **Revisão de código**
   - Verificar vulnerabilidades comuns
   - Revisar autenticação/autorização
   - Auditar práticas de manipulação de dados

3. **Infraestrutura**
   - Revisar variáveis de ambiente
   - Verificar controles de acesso
   - Auditar segurança de rede

## Checklist
- [ ] Dependências atualizadas e seguras
- [ ] Sem secrets hardcoded
- [ ] Validação de inputs implementada
- [ ] Autenticação segura
- [ ] Autorização configurada corretamente

Uso:

/security-audit Foque em autenticação e autorização

3. Setup New Feature​

# Setup New Feature

## Overview
Configurar sistematicamente uma nova feature do planejamento à estrutura de implementação.

## Passos

1. **Definir requisitos**
   - Esclarecer escopo e objetivos
   - Identificar user stories
   - Planejar abordagem técnica

2. **Criar feature branch**
   - Branch de main/develop
   - Configurar ambiente local
   - Configurar dependências

3. **Planejar arquitetura**
   - Design de modelos de dados e APIs
   - Planejar componentes UI e fluxo
   - Considerar estratégia de testes

## Checklist
- [ ] Requisitos documentados
- [ ] User stories escritas
- [ ] Abordagem técnica planejada
- [ ] Feature branch criada
- [ ] Ambiente de desenvolvimento pronto

Uso:

/setup-feature Feature de autenticação com OAuth

4. Create Pull Request​

# Create PR

## Overview
Criar um pull request bem estruturado com descrição adequada, labels e revisores.

## Passos

1. **Preparar branch**
   - Garantir que todas mudanças estão commitadas
   - Push da branch para remote
   - Verificar se branch está atualizada

2. **Escrever descrição**
   - Resumir mudanças claramente
   - Incluir contexto e motivação
   - Listar breaking changes
   - Adicionar screenshots se mudanças de UI

3. **Configurar PR**
   - Criar PR com título descritivo
   - Adicionar labels apropriados
   - Atribuir revisores
   - Linkar issues relacionados

## Template
- [ ] Feature A
- [ ] Bug fix B
- [ ] Testes unitários passando
- [ ] Testes manuais completos

Uso:

/create-pr Para feature de autenticação, inclui screenshots

Parâmetros e Contexto​

Você pode passar contexto adicional para os Commands:

/code-review Foque em performance e segurança do endpoint /api/users

O Agent receberá o conteúdo do Command mais o contexto adicional que você forneceu.

Team Commands​

Para times (planos Team e Enterprise), admins podem criar Commands no dashboard que são automaticamente sincronizados para todos os membros:

  1. Acesse Team Content Dashboard
  2. Crie um novo Command
  3. Defina:
    • Nome: Nome do comando (aparece após /)
    • Descrição: Contexto sobre o que faz
    • Conteúdo: Markdown com o workflow

Benefícios:

  • Gerenciamento centralizado: Atualize uma vez, todos recebem
  • Padronização: Garante workflows consistentes
  • Fácil compartilhamento: Sem necessidade de distribuir arquivos
  • Controle de acesso: Apenas admins podem criar/modificar

Benefícios no Dia a Dia​

Padronização​

  • Todos seguem os mesmos processos
  • Checklists consistentes
  • Menos esquecimentos

Produtividade​

  • Workflows complexos em um comando
  • Menos tempo explicando processos
  • Automação de tarefas repetitivas

Qualidade​

  • Nada é esquecido em reviews
  • Processos de segurança padronizados
  • Onboarding mais rápido

Colaboração​

  • Time alinhado em processos
  • Fácil compartilhamento de conhecimento
  • Documentação viva

Combinando Commands com Rules​

Commands funcionam ainda melhor quando combinados com Rules:

  1. Rules definem padrões e convenções
  2. Commands executam workflows usando esses padrões

Exemplo:

  • Rule define: "Sempre use TypeScript, siga padrões de nomenclatura"
  • Command /setup-feature usa essas Rules ao criar nova feature

Case Study: Commands para Documentação​

Em um projeto, criamos Commands específicos para documentação:

# Documentation Writer

## Objetivo
Criar e atualizar documentação técnica de alta qualidade.

## Contexto
- Localização: `apps/neo-docs/docs/`
- Site: https://docs.neospace.ai/
- Formato: Markdown com Docusaurus

## Instruções
1. Analise o código fonte
2. Identifique funcionalidades principais
3. Crie documentação incremental
4. Valide contra código real
5. Inclua exemplos práticos

Isso permitiu que qualquer membro do time criasse documentação consistente com um simples comando.

Best Practices​

✅ DO​

  • Seja específico: Instruções claras e acionáveis
  • Use checklists: Facilita seguir o processo
  • Inclua contexto: Explique o "porquê"
  • Mantenha atualizado: Revise e melhore regularmente
  • Compartilhe: Coloque no Git para o time

❌ DON'T​

  • Não seja vago: Evite instruções genéricas
  • Não exagere: Commands muito longos são menos úteis
  • Não duplique: Reutilize quando possível
  • Não ignore feedback: Melhore baseado no uso

Conclusão​

Cursor Commands são uma forma poderosa de padronizar workflows e aumentar produtividade. Eles transformam processos complexos em comandos simples, garantindo consistência e qualidade.

Ao criar Commands bem estruturados, você:

  • Padroniza processos do time
  • Aumenta produtividade
  • Melhora qualidade
  • Facilita colaboração

No próximo artigo, vamos ver um case study completo de como usamos Agents, Rules e Commands juntos para criar um sistema de documentação automatizado.

Próximos Passos​

  • Crie seu primeiro Command para um processo comum
  • Explore Team Commands se tiver plano Team/Enterprise
  • Combine Commands com Rules para máxima eficiência
  • Leia o Case Study completo

Aprofunde seu Conhecimento​

Quer aprender mais sobre Cursor? Explore nossa trilha completa de documentação:

Artigos Relacionados:

Referências: