Skip to main content

Casos Práticos

Neste capítulo, vamos ver exemplos reais de como usar Agents, Rules e Commands juntos para resolver problemas comuns de desenvolvimento.

Case Study: Sistema de Documentação Automatizada​

O Problema​

Time técnico precisava documentar uma plataforma de IA, mas:

  • Não tinha tech writer dedicado
  • Documentação ficava desatualizada
  • Inconsistências entre código e docs
  • Não sabiam por onde começar

A Solução​

Criamos um sistema completo com:

  1. Agents: @docs-writer e @docs-reviewer
  2. Rules: Padrões de documentação
  3. Commands: /docs-writer e /docs-reviewer

Estrutura Criada​

.cursor/
├── rules/
│   ├── docs-writer-agent.mdc
│   └── docs-reviewer-agent.mdc
└── commands/
    ├── docs-writer.md
    └── docs-reviewer.md

Workflow​

# 1. Desenvolver feature
git add apps/portal-web/src/pages/training/

# 2. Documentar
/docs-writer Documente as alterações staged relacionadas a Training

# 3. Revisar
/docs-reviewer Quick review da nova documentação de Training

# 4. Commit
git commit -m "feat: add training feature with docs"

Resultados​

  • ✅ Tempo de documentação: -70%
  • ✅ Qualidade: 7.5/10 → 9/10
  • ✅ Cobertura: 60% → 95%
  • ✅ Documentação sempre atualizada

Exemplo 1: Criar Nova Feature Completa​

Cenário​

Precisa criar uma feature de autenticação com login, registro e proteção de rotas.

Solução com Rules + Agents​

1. Rule para Autenticação:

---
description: "Padrões para autenticação"
globs: ["**/auth/**/*.ts", "**/auth/**/*.tsx"]
---

# Authentication Standards

- Use JWT tokens
- Valide com Zod
- Proteja rotas com middleware
- Inclua testes E2E
- Documente endpoints

2. Command /setup-feature:

# Setup New Feature

1. Criar estrutura de pastas
2. Configurar rotas
3. Implementar handlers
4. Criar testes
5. Adicionar documentação

3. Uso:

/setup-feature Feature de autenticação com login e registro

O Agent usará a Rule de autenticação e seguirá o workflow do Command.

Exemplo 2: Refatorar Código Legacy​

Cenário​

Precisa refatorar código JavaScript antigo para TypeScript moderno.

Solução​

1. Rule para TypeScript:

---
description: "Padrões TypeScript"
globs: ["**/*.ts", "**/*.tsx"]
---

# TypeScript Standards

- Use tipos explícitos
- Evite `any`
- Use interfaces para objetos
- Prefira `const` sobre `let`

2. Prompt para Agent:

Refatore este arquivo para TypeScript:
- Adicione tipos explícitos
- Converta para ES6+
- Mantenha funcionalidade
- Adicione testes
- Valide funcionamento

O Agent seguirá a Rule de TypeScript e fará a refatoração completa.

Exemplo 3: Code Review Automatizado​

Cenário​

Precisa fazer code review de um PR grande com múltiplos arquivos.

Solução​

1. Command /code-review:

# Code Review Checklist

## Functionality
- [ ] Código funciona como esperado
- [ ] Edge cases tratados
- [ ] Error handling adequado

## Code Quality
- [ ] Código legível
- [ ] Sem duplicação
- [ ] Segue padrões

## Security
- [ ] Sem vulnerabilidades
- [ ] Validação de inputs
- [ ] Sem secrets hardcoded

2. Uso:

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

O Agent seguirá o checklist e fornecerá feedback estruturado.

Exemplo 4: Migração de Biblioteca​

Cenário​

Precisa migrar de axios para fetch nativo.

Solução​

1. Rule para HTTP:

---
description: "Padrões para chamadas HTTP"
globs: ["**/api/**/*.ts"]
---

# HTTP Standards

- Use fetch nativo
- Trate erros adequadamente
- Use tipos TypeScript
- Documente endpoints

2. Prompt para Agent:

Migre todas as chamadas de axios para fetch:
- Substitua todas as chamadas
- Mantenha mesma interface
- Atualize tipos
- Atualize testes
- Valide funcionamento

O Agent encontrará todas as chamadas, migrará e validará.

Exemplo 5: Setup de Ambiente​

Cenário​

Novo desenvolvedor precisa configurar ambiente de desenvolvimento.

Solução​

1. Command /setup-environment:

# Setup Development Environment

1. Instalar dependências
2. Configurar variáveis de ambiente
3. Rodar migrations
4. Validar setup
5. Executar testes

2. Uso:

/setup-environment Configure ambiente completo

O Agent executará todos os passos e validará o setup.

Padrões de Uso​

Padrão 1: Rule + Agent​

  1. Crie Rule com padrões
  2. Use Agent que segue a Rule
  3. Resultado: Código consistente

Padrão 2: Command + Rule​

  1. Crie Command com workflow
  2. Command usa Rules do projeto
  3. Resultado: Processo padronizado

Padrão 3: Agent + Command​

  1. Use Command para iniciar
  2. Agent executa tarefa
  3. Resultado: Workflow automatizado

Best Practices Aplicadas​

✅ DO​

  • Combine ferramentas: Rules + Commands + Agents
  • Seja específico: Instruções claras
  • Valide resultados: Sempre revise
  • Itere: Melhore baseado em uso

❌ DON'T​

  • Não use isoladamente: Combine para máximo efeito
  • Não seja vago: Especifique exatamente o que precisa
  • Não ignore validação: Sempre valide resultados
  • Não esqueça de atualizar: Mantenha Rules e Commands atualizados

Artigos Relacionados​

Para ver um case study completo e detalhado:

Conclusão​

Estes casos práticos mostram como Agents, Rules e Commands trabalham juntos para criar soluções poderosas. A chave é pensar em workflow completo, não apenas em ferramentas isoladas.

No próximo capítulo, vamos ver best practices e dicas avançadas.

Próximo: Best Practices