sinapse-ai 7.0.5 → 7.2.0

package/docs/pt/platforms/cursor.md

@@ -1,633 +0,0 @@
-# Guia SINAPSE para Cursor
-
-> 🌐 [EN](../../platforms/cursor.md) | **PT** | [ES](../../es/platforms/cursor.md)
-
----
-
-> **Editor de Código AI-First** - IDE com IA Mais Popular
-
----
-
-## Visão Geral
-
-### O que é o Cursor?
-
-Cursor é um editor de código AI-first construído sobre o VS Code, projetado para tornar desenvolvedores mais produtivos com assistência de IA integrada. Ele combina recursos familiares do VS Code com poderosas capacidades de IA incluindo geração de código, edição e conversação.
-
-### Por que usar SINAPSE com Cursor?
-
-O Cursor é uma das **IDEs com IA mais populares** com excelente integração SINAPSE:
-
-- **Grande Base de Usuários**: Comunidade ativa e atualizações contínuas
-- **Ativação @mention**: Ativação natural de agentes com sintaxe @
-- **Integração Composer**: Edição multi-arquivo com assistência IA
-- **Contexto @codebase**: Entendimento completo do projeto
-- **Suporte MCP**: Extensível via configuração
-- **Compatibilidade VS Code**: Funciona com extensões do VS Code
-
-### Comparação com Outras Plataformas
-
-| -------------------- | :----: | :---------: | :------: |
-| Interface GUI        |  Sim   |     Não     |   Sim    |
-| Ativação @mention    |  Sim   |  /comando   |   Sim    |
-| Composer             |  Sim   |  Task Tool  | Cascade  |
-| Extensões VS Code    |  Sim   |     Não     | Limitado |
-| Suporte MCP          | Config |   Nativo    |  Config  |
-| Edição Multi-arquivo |  Sim   |     Sim     |   Sim    |
-
----
-
-## Requisitos
-
-### Requisitos de Sistema
-
-| Requisito           | Mínimo                           | Recomendado   |
-| ------------------- | -------------------------------- | ------------- |
-| **RAM**             | 4GB                              | 8GB+          |
-| **Espaço em Disco** | 500MB                            | 1GB+          |
-| **SO**              | macOS 10.15+, Windows 10+, Linux | Última versão |
-| **Node.js**         | 18.0+ (para SINAPSE)                | 20.0+         |
-
-### Requisitos de Conta
-
-- **Conta Cursor** (tier gratuito disponível)
-- **Chaves de API** (opcional): OpenAI, Anthropic, ou use modelos nativos do Cursor
-
-### Configuração Recomendada
-
-- Git instalado e configurado
-- GitHub CLI (`gh`) para operações de PR
-- Assinatura Cursor Pro para recursos avançados
-
----
-
-## Instalação
-
-### Passo 1: Instalar o Cursor
-
-1. Baixe em [cursor.com](https://cursor.com)
-2. Execute o instalador para sua plataforma
-3. Inicie o Cursor e faça login
-
-```bash
-# macOS (via Homebrew)
-brew install --cask cursor
-
-# Ou baixe diretamente de cursor.com
-```
-
-### Passo 2: Configurar as Configurações do Cursor
-
-Abra Configurações do Cursor (`Cmd/Ctrl + ,`):
-
-1. **AI Settings** > Habilitar recursos de IA
-2. **Models** > Selecionar modelo preferido (Claude, GPT-4, etc.)
-3. **Rules** > Habilitar regras personalizadas
-
-### Passo 3: Instalar o SINAPSE
-
-```bash
-# Navegue até seu projeto
-cd seu-projeto
-
-# Inicialize o SINAPSE
-npx @anthropic/sinapse init
-
-# Selecione "Cursor" quando solicitado para IDE
-```
-
-### Passo 4: Verificar a Instalação
-
-Verifique se os arquivos SINAPSE foram criados:
-
-```bash
-ls -la .cursor/
-```
-
-Estrutura esperada:
-
-```
-.cursor/
-├── rules.md           # Configuração principal de regras
-├── rules/             # Pasta de regras de agentes
-│   ├── dev.md
-│   ├── qa.md
-│   ├── architect.md
-│   └── ...
-└── settings.json      # Configurações locais do Cursor
-```
-
----
-
-## Configuração
-
-### Arquivo de Regras Principal
-
-**Localização:** `.cursor/rules.md`
-
-Este arquivo contém:
-
-- Regras e contexto específicos do projeto
-- Instruções de ativação de agentes
-- Padrões de desenvolvimento
-- Integração do framework SINAPSE
-
-### Pasta de Regras de Agentes
-
-**Localização:** `.cursor/rules/`
-
-Cada agente tem um arquivo dedicado:
-
-```
-.cursor/rules/
-├── dev.md          # Regras do agente desenvolvedor
-├── qa.md           # Regras do agente QA
-├── architect.md    # Regras do agente arquiteto
-├── pm.md           # Regras do gerente de projeto
-├── po.md           # Regras do product owner
-├── sm.md           # Regras do scrum master
-├── analyst.md      # Regras do analista de negócios
-└── devops.md       # Regras do agente DevOps
-```
-
-### Configurações do Cursor
-
-**Localização:** `.cursor/settings.json`
-
-```json
-{
-  "cursor.ai.enabled": true,
-  "cursor.ai.model": "claude-3-5-sonnet",
-  "cursor.rules.enabled": true,
-  "cursor.rules.path": ".cursor/rules.md"
-}
-```
-
-### Configuração MCP
-
-**Localização:** `~/.cursor/mcp.json` ou projeto `.cursor/mcp.json`
-
-```json
-{
-  "mcpServers": {
-    "filesystem": {
-      "command": "npx",
-      "args": ["-y", "@modelcontextprotocol/server-filesystem", "."]
-    }
-  }
-}
-```
-
----
-
-## Uso Básico
-
-### Iniciando o Cursor com SINAPSE
-
-1. Abra seu projeto no Cursor
-2. As regras em `.cursor/rules.md` são carregadas automaticamente
-3. Use o painel de chat IA (`Cmd/Ctrl + L`)
-
-### Ativando Agentes SINAPSE
-
-Agentes são ativados usando @mentions no chat:
-
-```
-@developer         # Agente desenvolvedor
-@quality-gate          # Agente engenheiro de QA
-@architect   # Agente arquiteto de software
-@project-lead          # Agente gerente de projeto
-@product-lead          # Agente product owner
-@sprint-lead          # Agente scrum master
-@analyst     # Agente analista de negócios
-@devops      # Agente engenheiro DevOps
-```
-
-### Exemplos de Ativação de Agentes
-
-```
-@developer implemente a feature de autenticação seguindo a story
-
-@quality-gate revise este código para vulnerabilidades de segurança
-
-@architect projete a arquitetura de microserviços para o sistema de pagamento
-
-@project-lead crie um plano de sprint para as próximas duas semanas
-```
-
-### Usando o Composer
-
-O Composer do Cursor permite edição multi-arquivo:
-
-1. Abra o Composer (`Cmd/Ctrl + I`)
-2. Descreva suas alterações
-3. Selecione arquivos para modificar
-4. Revise e aplique alterações
-
-```
-# Exemplo de prompt do Composer
-@developer Crie um novo endpoint REST API para registro de usuário.
-Inclua:
-- Handler de rota em src/routes/
-- Middleware de validação
-- Lógica da camada de serviço
-- Testes unitários
-```
-
-### Usando @codebase
-
-Referencie o contexto completo do seu projeto:
-
-```
-@codebase Como a autenticação está atualmente implementada?
-
-@codebase @developer Refatore as queries do banco de dados para usar o padrão repository
-```
-
----
-
-## Uso Avançado
-
-### Fluxos de Trabalho do Composer
-
-#### Refatoração Multi-Arquivo
-
-```
-@architect @codebase
-Refatore o módulo de usuário para seguir clean architecture:
-1. Extrair interfaces
-2. Criar camada de repositório
-3. Atualizar serviços
-4. Manter testes
-```
-
-#### Implementação de Feature
-
-```
-@developer @codebase
-Implemente a feature de carrinho de compras:
-- Modelo e migrations do carrinho
-- Operações CRUD
-- Persistência de sessão
-- Endpoints de API
-```
-
-### Modos de Chat
-
-O Cursor suporta diferentes modos de interação:
-
-| Modo         | Caso de Uso                   |
-| ------------ | ----------------------------- |
-| **Chat**     | Perguntas gerais, explicações |
-| **Edit**     | Modificações inline de código |
-| **Composer** | Alterações multi-arquivo      |
-| **Terminal** | Execução de comandos          |
-
-### Edição Inline
-
-Selecione código e use `Cmd/Ctrl + K`:
-
-```
-# Selecione código, então:
-@developer otimize esta função para performance
-@quality-gate adicione tratamento de erros a este bloco
-```
-
-### Organização de Regras
-
-Organize regras por contexto:
-
-```
-.cursor/
-├── rules.md              # Regras globais
-└── rules/
-    ├── agents/           # Regras específicas de agentes
-    │   ├── dev.md
-    │   └── qa.md
-    ├── patterns/         # Padrões de código
-    │   ├── api.md
-    │   └── testing.md
-    └── project/          # Específico do projeto
-        └── conventions.md
-```
-
----
-
-## Recursos Específicos do Cursor
-
-### Superpoderes
-
-| Recurso         | Descrição                 |
-| --------------- | ------------------------- |
-| **Cmd+K**       | Edição IA inline          |
-| **Cmd+L**       | Abrir chat IA             |
-| **Cmd+I**       | Abrir Composer            |
-| **Cmd+Shift+L** | Adicionar seleção ao chat |
-| **Tab**         | Aceitar sugestão IA       |
-
-### Atalhos de Teclado
-
-| Atalho                 | Ação                 |
-| ---------------------- | -------------------- |
-| `Cmd/Ctrl + K`         | Edição IA            |
-| `Cmd/Ctrl + L`         | Chat IA              |
-| `Cmd/Ctrl + I`         | Composer             |
-| `Cmd/Ctrl + Shift + K` | Editar com seleção   |
-| `Escape`               | Cancelar operação IA |
-
-### Referências de Contexto
-
-Use estas no chat ou Composer:
-
-| Referência     | Descrição                    |
-| -------------- | ---------------------------- |
-| `@codebase`    | Contexto completo do projeto |
-| `@file`        | Arquivo específico           |
-| `@folder`      | Conteúdo da pasta            |
-| `@docs`        | Documentação                 |
-| `@web`         | Busca web                    |
-| `@nome-agente` | Agente SINAPSE                  |
-
-### Seleção de Modelo
-
-Mude de modelo baseado na tarefa:
-
-| Modelo                | Melhor Para                      |
-| --------------------- | -------------------------------- |
-| **Claude 3.5 Sonnet** | Raciocínio complexo, arquitetura |
-| **GPT-4**             | Codificação geral                |
-| **GPT-4 Turbo**       | Respostas rápidas                |
-| **Cursor Small**      | Completações rápidas             |
-
----
-
-## Sincronização de Agentes
-
-### Como Funciona
-
-```mermaid
-flowchart LR
-    Source["SINAPSE Core<br/>.sinapse-ai/development/agents"] --> Parser["Parser de Agente"]
-    Parser --> Transform["Transformador Cursor"]
-    Transform --> Output[".cursor/rules/"]
-```
-
-### Comandos de Sincronização
-
-```bash
-# Sincronizar todos os agentes
-npm run sync:ide
-
-# Sincronizar agente específico
-npm run sync:ide
-
-# Forçar ressincronização
-npm run sync:ide
-```
-
-### Formato de Arquivo de Agente
-
-Agentes no Cursor usam formato markdown condensado:
-
-```markdown
-# Agente Desenvolvedor (@developer)
-
-## Papel
-
-Desenvolvedor Full Stack Sênior focado em código limpo e manutenível.
-
-## Expertise
-
-- TypeScript/JavaScript
-- Node.js/React
-- Design de banco de dados
-- Desenvolvimento de API
-
-## Fluxo de Trabalho
-
-1. Entender requisitos da story
-2. Planejar abordagem de implementação
-3. Escrever código limpo e testado
-4. Atualizar progresso da story
-
-## Padrões
-
-- Seguir convenções existentes do codebase
-- Escrever tratamento abrangente de erros
-- Incluir testes unitários para código novo
-```
-
-### Resolução de Conflitos
-
-Quando conflitos ocorrem durante o sync:
-
-1. Backup criado em `.cursor/rules/.backup/`
-2. Prompt para estratégia de resolução
-3. Opções: manter local, usar remoto, mesclar
-
----
-
-## Limitações Conhecidas
-
-### Limitações Atuais
-
-| Limitação                     | Solução Alternativa             |
-| ----------------------------- | ------------------------------- |
-| Sem MCP nativo                | Use MCP baseado em configuração |
-| Sem spawn de subagente        | Troca manual de agente          |
-| Limites de janela de contexto | Use @codebase seletivamente     |
-| Rate limiting                 | Configure nas configurações     |
-
-### Cursor vs Claude Code
-
-| Aspecto     | Cursor | Claude Code |
-| ----------- | ------ | ----------- |
-| Task Tool   | Não    | Sim         |
-| Hooks       | Não    | Sim         |
-| Skills      | Não    | Nativo      |
-| GUI         | Sim    | Não         |
-| Ext VS Code | Sim    | Não         |
-
-### Problemas Conhecidos
-
-- Projetos grandes podem deixar @codebase lento
-- Algumas extensões VS Code podem conflitar
-- MCP requer configuração manual
-
----
-
-## Troubleshooting
-
-### Problemas Comuns
-
-#### Regras Não Carregando
-
-```
-Problema: Agente não responde a @mentions
-```
-
-**Solução:**
-
-1. Verifique se arquivo de regras existe: `ls .cursor/rules.md`
-2. Confira Cursor settings > Rules > Enabled
-3. Reinicie o Cursor
-
-#### MCP Não Funcionando
-
-```
-Problema: Ferramentas MCP não disponíveis
-```
-
-**Solução:**
-
-```bash
-# Verificar configuração MCP
-cat ~/.cursor/mcp.json
-
-# Verificar se servidor MCP está instalado
-npx @modelcontextprotocol/server-filesystem --version
-```
-
-#### Performance Lenta
-
-```
-Problema: Cursor está lento com projetos grandes
-```
-
-**Solução:**
-
-1. Exclua pastas grandes em `.cursorignore`
-2. Use referências específicas de arquivo ao invés de @codebase
-3. Aumente alocação de memória nas configurações
-
-#### Agente Não Reconhecido
-
-```
-Problema: @developer não ativa agente
-```
-
-**Solução:**
-
-```bash
-# Ressincronizar agentes
-npm run sync:ide
-
-# Verificar se arquivo do agente existe
-ls .cursor/rules/dev.md
-```
-
-### Logs e Diagnósticos
-
-```bash
-# Localização dos logs do Cursor
-# macOS: ~/Library/Application Support/Cursor/logs/
-# Windows: %APPDATA%\Cursor\logs\
-# Linux: ~/.config/Cursor/logs/
-
-# Ver log mais recente
-tail -f ~/Library/Application\ Support/Cursor/logs/main.log
-```
-
-### Resetar Configuração
-
-```bash
-# Backup da configuração atual
-cp -r .cursor/ .cursor-backup/
-
-# Reinicializar SINAPSE
-npx @anthropic/sinapse init --ide cursor --force
-```
-
----
-
-## FAQ
-
-### Perguntas Gerais
-
-**P: O Cursor é gratuito?**
-R: O Cursor tem um tier gratuito com requisições IA limitadas. Assinatura Pro disponível para acesso ilimitado.
-
-**P: Posso usar minhas próprias chaves de API?**
-R: Sim, você pode configurar chaves de API OpenAI ou Anthropic nas configurações do Cursor.
-
-**P: O Cursor funciona offline?**
-R: Edição básica funciona offline, mas recursos de IA requerem internet.
-
-### Perguntas Específicas do SINAPSE
-
-**P: Como mudo entre agentes?**
-R: Use @mentions no chat: `@dev`, `@qa`, `@architect`, etc.
-
-**P: Posso usar múltiplos agentes em um prompt?**
-R: Sim, mas é recomendado usar um agente por tarefa para clareza.
-
-**P: Onde as definições de agentes são armazenadas?**
-R: Em `.cursor/rules/` após a sincronização.
-
-**P: Como atualizo os agentes?**
-R: Execute `npm run sync:ide` após atualizações do SINAPSE.
-
----
-
-## Migração
-
-### Do VS Code para Cursor
-
-1. O Cursor importa configurações do VS Code automaticamente
-2. Instale o SINAPSE:
-   ```bash
-   npx @anthropic/sinapse init --ide cursor
-   ```
-3. Suas extensões VS Code devem funcionar no Cursor
-
-### Do Cursor para Claude Code
-
-1. Exporte regras personalizadas:
-
-   ```bash
-   cp -r .cursor/rules/ cursor-rules-backup/
-   ```
-
-2. Inicialize SINAPSE para Claude Code:
-
-   ```bash
-   npx @anthropic/sinapse init --ide claude-code
-   ```
-
-3. Agentes sincronizam automaticamente para o novo formato
-
-
-1. Exporte configuração:
-
-   ```bash
-   cp .cursor/rules.md cursor-rules-backup.md
-   ```
-
-
-   ```bash
-   ```
-
-
----
-
-## Recursos Adicionais
-
-### Documentação Oficial
-
-- [Documentação do Cursor](https://cursor.com/docs)
-- [Changelog do Cursor](https://cursor.com/changelog)
-- [Discord do Cursor](https://discord.gg/cursor)
-
-### Comunidade
-
-- [Reddit do Cursor](https://reddit.com/r/cursor)
-- [GitHub Discussions](https://github.com/getcursor/cursor/discussions)
-
-### Tutoriais
-
-- [Dicas e Truques do Cursor](https://cursor.com/tips)
-- [Guia de Integração SINAPSE](../README.md)
-
----
-
-_SINAPSE - Guia da Plataforma Cursor v1.0_