Skip to main content

Curadoria de Contexto e Higiene de Regras

PARA AGENTES DE IAChatGPTClaude

Prática de engenharia para projetar, auditar regularmente e limpar arquivos de configuração de comportamento do agente (.cursorrules, .clinerules, AGENTS.md) para prevenir a degradação da atenção do modelo.

1. Visão geral do conceito e o problema sistêmico

Desenvolvedores frequentemente tratam arquivos como .cursorrules ou .clinerules como lixeiras:

  • Surgiu um bug? Adicionaram uma regra: "Nunca use a biblioteca X".
  • Uma semana depois, outro desenvolvedor adicionou: "Use a biblioteca X para operações rápidas".
  • Em três meses, o arquivo se transforma em um rolo ilegível com 80 instruções contraditórias.
  • O modelo é forçado a ler esse caos em cada requisição, desperdiçando tokens e degradando a qualidade da geração.

Context Curation é a disciplina de minimalismo e pureza arquitetural: as regras de sistema devem ser modulares, hierárquicas, atuais e concisas.

2. Taxonomia arquitetural e modelo mental

┌─────────────────────────────────────────────────────────────┐
│                 MODULAR CONTEXT HIERARCHY                   │
├─────────────────────────────────────────────────────────────┤
│ 1. ROOT RULES (.cursorrules / AGENTS.md) [Max 150 lines]    │
│    • Core stack & strict boundaries (Next.js 15, Drizzle)   │
│    • Ban-list (No any, no ts-ignore, no unverified deps)    │
│    • Verification command: `pnpm check && pnpm test`        │
├─────────────────────────────────────────────────────────────┤
│                          │                                  │
│                          ▼ On-demand dynamic loading        │
├─────────────────────────────────────────────────────────────┤
│ 2. DOMAIN SKILLS & SUBSYSTEM SPECS (.agents/skills/)        │
│    • `skills/better-auth/` ➔ loaded ONLY during auth tasks   │
│    • `skills/seo-audit/`   ➔ loaded ONLY for marketing pages│
│    • `skills/db-migrations/` ➔ loaded ONLY for schema edits │
└─────────────────────────────────────────────────────────────┘

3. Cenários práticos de engenharia em produção

01. Regra de "Proibição Explícita" (Negative Constraints)

Em vez de longas descrições sobre como escrever código, regras de alta qualidade formulam claramente as ações proibidas:

## Strict Invariants
- NEVER run `npm run build` locally during dev; use `tsc --noEmit`.
- NEVER use inline CSS styles; use Tailwind design tokens.
- NEVER invent mock user IDs; query database fixtures.

02. Uso de referências relativas em vez de copiar e colar código

Em vez de copiar todo o arquivo de tipos no .cursorrules, indique referências:

Before modifying database entities, read schema definitions in [schema.ts](file:///src/db/schema.ts).

Ambientes agênticos modernos buscarão o conteúdo do arquivo automaticamente quando necessário.

4. Armadilhas, erros comuns e segurança

  • Tentar ensinar o modelo de linguagem via regras: Não escreva nas regras palestras sobre o que é assincronidade em JavaScript ou como funcionam Promises. O modelo já sabe isso. As regras são necessárias exclusivamente para especificidades do seu repositório.
  • Perda de atualidade: Se o projeto migrou do Tailwind v3 para o Tailwind v4, regras antigas com utilitários obsoletos causarão erros de sintaxe. Realize auditorias mensais das regras.

5. Conclusão estratégica para o engenheiro de 2026

A qualidade do trabalho do agente é diretamente proporcional à pureza do contexto que você lhe fornece. A curadoria de contexto é o equivalente digital da esterilidade em uma mesa cirúrgica: ferramentas desnecessárias são removidas, e as essenciais estão posicionadas em seus locais definidos.

/ Perguntas FrequentesSchema.org FAQPage

FAQ: Curadoria de Contexto e Higiene de Regras

Os modelos possuem uma capacidade limitada de alocação de atenção (Attention Budget). Se você carregar centenas de regras não estruturadas, o modelo começará a ignorá-las ou confundir as prioridades, resultando em degradação das respostas (Context Rot) e aumento dos custos de tokens.
/ Links internos

Termos relacionados

Todos os termos
Vibecoding & IDEs

Regras de Agente (.cursorrules / CLAUDE.md / AGENTS.md)

Arquivos de especificações e restrições arquitetônicas legíveis por máquina no repositório, montados automaticamente no contexto do sistema dos agentes de IA para evitar a degradação da base de código.

Ler termo
Prompts & RAG

Degradação de Contexto (Context Rot & Attention Decay)

Redução sistêmica da precisão, do seguimento de instruções e da coerência lógica dos LLMs à medida que se acumulam no contexto de trabalho ruído de diálogo, rascunhos de código obsoletos e saídas do compilador.

Ler termo
Prompts & RAG

System Prompt (System Instructions & Metaprompting)

Priority meta-contextual instruction block transmitted at the zero position of the context window, defining the agent's role, security rules, available tools, and behavioral boundaries.

Ler termo
Vibecoding & IDEs

Engenharia Orientada a Especificações (Desenvolvimento com IA Guiado por RFCs)

Metodologia de desenvolvimento assistido por IA, onde 80% do esforço do engenheiro é dedicado à criação de especificações técnicas cristalinas (PRD/RFC) antes da geração da primeira linha de código.

Ler termo