Assistentes de Código & Pair Programming com IA

O desenvolvimento com IA evoluiu do simples autocompletion (como GitHub Copilot v1) para agentes de engenharia com raciocínio contextual. Ferramentas modernas não apenas sugerem a próxima linha; elas leem árvores de dependência, executam testes, criam branches, interagem com servidores MCP e propõem diffs atômicos.

O arquivo único .cursorrules ainda é lido. No Cursor, o lugar atual das regras é .cursor/rules. Para agentes fora do editor, AGENTS.md na raiz cumpre o mesmo papel: stack, o que não instalar e como o código deste repositório se parece.

Exemplo de .cursorrules para Projetos Modernos:

# Contexto & Diretrizes do Projeto (.cursorrules)

## Stack Tecnológica
- Backend: Node.js 22 LTS / TypeScript em strict / Fastify
- Banco de Dados: PostgreSQL com Prisma ORM e pgvector
- Testes: Vitest + Supertest

## Regras Críticas de Código
1. SEMPRE utilize TypeScript strict mode sem 'any' explícito.
2. Não instale dependências novas sem justificativa no plano de ação.
3. Toda rota HTTP deve conter validação de schema Zod (Request + Response).
4. Funções assíncronas devem usar try/catch tipado com Custom AppError.
5. Não altere arquivos de migração já aplicados (database/migrations).

## Padrão de Resposta do Agente
- Mostre primeiro o plano em 3 passos concisos.
- Aplique o menor diff possível preservando comentários existentes.
- Execute 'npm run test:unit' mentalmente para garantir conformidade.

O Claude Code é a ferramenta de linha de comando agêntica desenvolvida pela Anthropic. Ele opera diretamente no repositório local, navegando por pastas, lendo commits do Git, executando scripts de build e criando Pull Requests com autonomia supervisionada.

Instalação e Inicialização

# Instalação global via npm
npm install -g @anthropic-ai/claude-code

# Autenticação e inicialização dentro do repositório
cd meu-projeto/
claude

# Exemplo de comando direto com tarefa cirúrgica:
claude "Analise todos os endpoints em src/routes/ e adicione testes unitários para casos de erro 400 e 404"

Configuração de CLAUDE.md no Projeto

Assim como o .cursorrules, o Claude Code procura por um arquivo CLAUDE.md na raiz do repositório para carregar o manual de operações do projeto antes de qualquer ação.

# CLAUDE.md - Guia de Execução do Repositório

## Comandos de Build & Teste
- Compilar: `npm run build`
- Testes Unitários: `npm test`
- Linter: `npm run lint -- --fix`

## Política de Git
- Crie branches com padrão `feat/nome-da-feature` ou `fix/nome-do-bug`.
- Commits devem seguir Conventional Commits (ex: `feat(auth): add JWT refresh handler`).
- NUNCA dê force push na branch `main`.

O Cline (e o fork Roo Code) liga um modelo ao VS Code e a servidores MCP. Em setembro de 2026 os ids que valem a pena testar são da linha Claude atual (Sonnet 5 e acima), da linha GPT que o provedor expõe, ou um peso local via Ollama. Claude 3.7 e GPT-4o ficaram para trás.

Configuração de Servidores MCP no Cline (`cline_mcp_settings.json`)

{
  "mcpServers": {
    "postgres-local": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-postgres",
        "postgresql://postgres:postgres@localhost:5432/meu_banco"
      ]
    },
    "puppeteer-browser": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-puppeteer"
      ]
    }
  }
}

Com essa configuração, o agente consegue inspecionar schemas do banco em tempo real e testar a UI no browser antes de finalizar o código.

Modelos de linguagem são estatísticos. Para garantir que o código gerado funcione em 100% dos casos em produção, adote a Tríade de Validação Automatizada: