⚙️ Stack Técnico Avançado

Em 2026, a escolha de IDE não é mais sobre preferência pessoal — é sobre adequação à tarefa. Cursor, Windsurf e Claude Code têm arquiteturas diferentes que os tornam ideais para contextos distintos. Usar a ferramenta errada significa perder 30-50% da produtividade potencial.

Arquivos de regras persistentes são a técnica com melhor ROI em todo o vibe coding profissional. Uma vez configurados, eliminam a necessidade de repetir contexto a cada sessão e garantem que o agente sempre respeite os padrões do projeto.

# Projeto: API de Pagamentos (CLAUDE.md)

## Stack
- Node.js 22 + TypeScript strict mode
- Fastify (não Express — nunca usar Express)
- PostgreSQL via Prisma ORM
- Supabase Auth para autenticação

## Regras críticas
- NUNCA hardcodar secrets — sempre process.env
- NUNCA fazer queries SQL diretas — sempre via Prisma
- SEMPRE adicionar RLS policies em novas tabelas Supabase
- SEMPRE criar testes unitários para nova lógica de negócio
- NUNCA modificar arquivos em src/migrations/

## Padrões de código
- Nomenclatura: camelCase para variáveis, PascalCase para tipos
- Erros: sempre usar Result type (never throw)
- Imports: absolutos com alias @/
- Max 200 linhas por arquivo

## Comandos úteis
- npm run test — rodar suite de testes
- npm run lint — verificar padrões
- npm run db:migrate — aplicar migrations

O MCP é o que transforma um agente de IA de um "assistente de texto sofisticado" em um operador real do seu ambiente de desenvolvimento. Criado pela Anthropic e adotado como padrão aberto em 2025, o protocolo define como modelos se conectam a ferramentas externas de forma segura e padronizada.

// claude_desktop_config.json
{
  "mcpServers": {
    "supabase": {
      "command": "npx",
      "args": ["-y", "@supabase/mcp-server-supabase@latest"],
      "env": {
        "SUPABASE_URL": "https://seu-projeto.supabase.co",
        "SUPABASE_SERVICE_KEY": "${SUPABASE_SERVICE_KEY}"
      }
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
      }
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem",
               "/home/user/projects"]
    }
  }
}

Usar Claude Opus para tudo é como contratar um arquiteto sênior para apertar parafusos. Usar Haiku para decisões arquiteturais é como pedir para um estagiário projetar a fundação de um prédio. A roteagem inteligente de modelos é uma vantagem competitiva real em custo e qualidade.

O ambiente de desenvolvimento define o que o agente pode fazer. Com as extensões certas configuradas, o código gerado pela IA já sai formatado, testado e revisado automaticamente. Sem elas, você passa horas corrigindo problemas que deveriam ser prevenidos.

# .husky/pre-commit
#!/bin/sh
npm run lint        # ESLint deve passar
npm run test:unit   # Testes unitários devem passar
npm run type-check  # TypeScript sem erros

# O agente aprende que seu código precisa passar
# nesses checks antes de fazer commit

A maior causa de código incorreto gerado por IA não é a limitação do modelo — é a falta de contexto relevante. O agente não pode corrigir o que não pode ver. Referenciar explicitamente os arquivos certos é a diferença entre uma sessão produtiva e uma frustrante.

"Adicione validação no endpoint
de criação de usuário.

Arquivos relevantes:
@src/routes/users.ts
@src/schemas/user.schema.ts
@src/middleware/auth.ts

O erro de validação deve retornar
422 com o campo inválido."

"Adicione validação no endpoint
de criação de usuário.

Meu projeto usa Fastify com
TypeScript e tem um arquivo de
rotas de usuários em algum lugar
e um schema de validação."

Dados da GitClear (2025) mostram que a produtividade com IA varia de +200% em tasks de CRUD a -20% em algoritmos de alta performance. Sem medir, você não sabe em quais contextos está se beneficiando e onde está perdendo tempo com correções.