Guia de Compatibilidade — Cursor, Antigravity e VS Code
Arquivo: docs/onboarding/ide-compatibility-guide.md
Suporte por IDE
| Recurso | Claude Code | Cursor | Antigravity (VS Code) | VS Code puro |
|---|---|---|---|---|
| Contexto Speckit | ✅ Automático | ✅ via .cursor/rules/ |
✅ via .cursor/rules/ |
✅ Manual |
| Agentes | ✅ Automático | ✅ via rules + chat | ✅ via rules + chat | ⚠️ Manual |
/analyze-bug |
✅ Comando nativo | ✅ Task (Ctrl+Shift+1) |
✅ Task (Ctrl+Shift+1) |
✅ Task |
/generate-fix |
✅ Comando nativo | ✅ Task (Ctrl+Shift+2) |
✅ Task (Ctrl+Shift+2) |
✅ Task |
/run-regression |
✅ Comando nativo | ✅ Task (Ctrl+Shift+3) |
✅ Task (Ctrl+Shift+3) |
✅ Task |
/open-pr |
✅ Comando nativo | ✅ Task (Ctrl+Shift+4) |
✅ Task (Ctrl+Shift+4) |
✅ Task |
/release-check |
✅ Comando nativo | ✅ Task (Ctrl+Shift+5) |
✅ Task (Ctrl+Shift+5) |
✅ Task |
| Hooks automáticos | ✅ Automático | ⚠️ Tasks manuais | ⚠️ Tasks manuais | ⚠️ Tasks manuais |
| Pipeline encadeado | ✅ Automático | ⚠️ Manual entre estágios | ⚠️ Manual entre estágios | ⚠️ Manual |
| Políticas enforced | ✅ Automático | ✅ via 04-policies.mdc |
✅ via 04-policies.mdc |
⚠️ Depende do dev |
| Bootstrap Speckit | ✅ Script | ✅ Task | ✅ Task | ✅ Script direto |
| Update Speckit CI | ✅ Pipeline | ✅ Pipeline | ✅ Pipeline | ✅ Pipeline |
Como usar no Cursor
Setup inicial
O Cursor lê as rules automaticamente de .cursor/rules/*.mdc.
Nenhuma configuração adicional necessária após clonar o repo.
Fluxo de trabalho
Opção A — Tasks (recomendado para iniciantes)
Ctrl+Shift+P → "Tasks: Run Task" → "NS Flow Kit: analyze-bug"
→ Digitar número do ticket
→ Copiar o prompt gerado no terminal
→ Colar no Cursor Chat (Ctrl+L)
→ AI executa como bug-investigator
Opção B — Direto no chat (recomendado para devs experientes)
Ctrl+L → abrir Cursor Chat
→ Selecionar arquivo .cursor/rules/01-bug-investigator.mdc como contexto
→ Copiar o prompt template do arquivo
→ Preencher os valores e enviar
Opção C — @-mentions no chat
No Cursor Chat, use @-mentions para incluir contexto específico:
@.speckit/known-issues/anti-patterns.md
@.claude/agents/bug-investigator.md
@.ns-flow/analysis/ADO-4821-bugreport.md
Analise o bug ADO-4821 e produza o ImpactReport.
Cursor Rules ativas
| Arquivo | Quando ativa |
|---|---|
00-adlc-context.mdc |
Sempre — contexto base em toda sessão |
01-bug-investigator.mdc |
Ao abrir arquivos em .ns-flow/analysis/ |
02-impact-analyzer.mdc |
Ao abrir BugReports |
03-agents-build-test-release.mdc |
Ao abrir patches, testes, PR descriptions |
04-policies.mdc |
Sempre — ao editar código ou SQL |
05-stack-standards.mdc |
Sempre — ao editar código |
06-speckit-lookup.mdc |
Ao abrir arquivos Speckit ou BMAD |
Como usar no Antigravity (VS Code-based)
O Antigravity é baseado em VS Code e lê as mesmas estruturas de configuração.
Setup
- Abrir o repo no Antigravity
- As rules em
.cursor/rules/são reconhecidas automaticamente - As tasks em
.vscode/tasks.jsonaparecem no Task Explorer
Diferença em relação ao Cursor
O Antigravity tem foco em geração de apps novos (vibe coding + Firebase).
Para uso com o NS Flow Kit kit em sistemas legados, o fluxo é idêntico ao Cursor:
- Rules ativas automaticamente
- Tasks disponíveis via Ctrl+Shift+P
- Chat do AI recebe os prompts dos agentes
Dica específica para Antigravity
O Antigravity tem contexto de projeto mais profundo que o Cursor padrão. Use isso a seu favor: ao iniciar uma sessão, diga ao AI:
Estou trabalhando em um sistema legado com o ns-flow-kit.
Leia .claude/context/operating-context.md e .speckit/domain/system-overview.md
antes de qualquer análise.
Como usar no VS Code puro (sem Cursor/Antigravity)
Sem um AI agent nativo, o fluxo é semi-manual mas ainda estruturado.
Com GitHub Copilot Chat
O Copilot lê .github/copilot-instructions.md automaticamente como instrução de repositório — o
contexto base do NS Flow Kit (princípios, ciclo de agentes, políticas) já entra sem você fazer nada.
Para uma etapa específica, adicione os arquivos canônicos via #file::
1. Abrir Copilot Chat (Ctrl+Shift+I) — .github/copilot-instructions.md já está ativo
2. Adicionar contexto da etapa via #file:
#file:.claude/agents/bug-investigator.md
#file:.speckit/domain/system-overview.md
#file:.speckit/known-issues/anti-patterns.md
3. Pedir a tarefa citando o ticket ID; parar nos checkpoints
As tasks
Ctrl+Shift+1..5(.vscode/tasks.json) geram o prompt pronto de cada etapa para colar no chat.
Com Gemini Code Assist
Mesmo processo — Gemini Code Assist no VS Code suporta #file: references.
Sem AI integrado
Use as tasks para inicializar workspaces e os scripts diretamente:
# Terminal integrado do VS Code
bash scripts/init-ticket.sh ADO-4821 bug
bash scripts/bootstrap-speckit.sh --repo . --system CITWEB --stack dotnet
E use Claude.ai, ChatGPT ou Gemini no browser com os prompts dos arquivos .cursor/rules/.
Qual IDE usar para qual situação
| Situação | Recomendação |
|---|---|
| Dev experiente, precisa de controle total | Claude Code ou Cursor |
| Dev junior, quer guia passo a passo | Cursor com tasks Ctrl+Shift+1..5 |
| Time Google Cloud / Firebase | Antigravity — compatível |
| Time com GitHub Copilot licenciado | VS Code + Copilot Chat |
| Ambiente corporativo restrito | VS Code puro + scripts manuais |
| CI/CD automatizado | Scripts independentes de IDE |
Configuração de keybindings no Cursor / Antigravity
Copie o conteúdo de .vscode/keybindings-suggestion.json para suas keybindings:
Ctrl+Shift+P → "Open Keyboard Shortcuts (JSON)"
Cole os bindings e salve. Os atalhos Ctrl+Shift+1 a Ctrl+Shift+5
ficarão disponíveis para os 5 comandos NS Flow Kit principais.