Escrevendo Regras Cirúrgicas: Máxima Densidade por Token

Escrevendo Regras Cirúrgicas: Máxima Densidade por Token — aula do módulo Regras de Agentes & AGENTS.md, na trilha Governança Ágil com Método OKAM da formação…

Leitura de aproximadamente 4 minutos.

Módulo: Regras de Agentes & AGENTS.md · Curso: Governança Ágil com Método OKAM · Formação: Formação Nível Zero: Ferramentas Essenciais e Gratuitas de IA e Código

Escrevendo Regras Cirúrgicas: Máxima Densidade por Token

O que você vai aprender

O que é o fenômeno da diluição de atenção em modelos de linguagem e por que textos prolixos falham.
O conceito de Máxima Densidade por Token: como transmitir ordens cristalinas com o menor número de palavras possível.
O poder das listas planas, verbos imperativos e regras no formato causa-efeito.
Como transformar parágrafos confusos em diretrizes cirúrgicas e infalíveis para seu arquivo de governança.

1. Por Que Modelos de IA Ignoram Textos Longos e Educados?

Muitas pessoas tratam a IA como se estivessem redigindo um e-mail corporativo ou uma carta de apresentação:

"Olá assistente, por favor, se você não se importar, gostaria muito que você tentasse evitar colocar estilos dentro do HTML, porque nós preferimos organizar o CSS em outro lugar para facilitar a leitura da equipe, caso seja possível."

Embora a intenção seja boa, essa forma de redigir é péssima para um modelo de linguagem por dois motivos:

1. Gasto Inútil de Janela de Atenção: As palavras de cortesia ("por favor", "se você não se importar", "gostaria muito") competem pela atenção matemática do modelo contra as instruções reais. 2. Ambiguidade Linguística: Expressões condicionais como "se possível" e "tentasse evitar" são interpretadas pela IA como sugestões opcionais, não como regras obrigatórias.

No método OKAM, adotamos o princípio da Máxima Densidade por Token: cada palavra deve carregar significado técnico e peso decisório imediato.

2. A Diluição de Atenção vs Densidade por Token

Modelos de IA distribuem sua capacidade de atenção ponderando todos os termos presentes no contexto. Quando o texto é direto e conciso, o peso atencional sobre a regra central atinge o valor máximo:


+-------------------------------------------------------------------------------+
|                       DILUIÇÃO DE ATENÇÃO VS ALTA DENSIDADE                   |
+-------------------------------------------------------------------------------+
|                                                                               |
|  [ TEXTO PROLIXO E CONVERSACIONAL ]                                           |
|  "Olá... por gentileza... tente não... se possível... colocar CSS aqui..."   |
|  └──> Atenção dispersa em palavras vazias (Baixa aderência da IA)             |
|                                                                               |
|  [ DIRETRIZ CIRÚRGICA DE ALTA DENSIDADE ]                                     |
|  "Proibido estilo inline. Todo CSS deve viver exclusivamente em src/style.css"|
|  └──> 100% de foco no imperativo técnico (Máxima aderência da IA)             |
|                                                                               |
+-------------------------------------------------------------------------------+

3. As Quatro Leis da Escrita Cirúrgica

Para redigir regras que a IA respeita rigorosamente, siga estas quatro diretrizes:

1. Use Verbos no Imperativo Direto

Substitua "Recomenda-se que você use..." por "Use...", "Mantenha...", "Crie..." ou "Nunca modifique...".

2. Prefira Listas Planas a Parágrafos

Grandes blocos de texto corrido dificultam a leitura rápida tanto para você quanto para o algoritmo. Use tópicos curtos (um conceito por linha).

3. Estabeleça Relações de Causa e Efeito

Sempre que uma escolha depender de uma condição, declare a fórmula Se [Condição] => [Ação]:

"Se encontrar erro de sintaxe => interrompa a execução e informe o arquivo afetado."
"Se a alteração exigir mais de 2 arquivos => solicite confirmação antes de editar."

4. Elimine Adjetivos Vagos

Palavras como "código bonito", "design elegante" ou "estrutura moderna" não significam nada para uma máquina. Substitua por parâmetros mensuráveis: "use espaçamento de 16px", "adote paleta de cores neutras", "use tags semânticas <main> e <article>".

4. Tabela Comparativa: Antes e Depois

| Situação | Regra Ruim (Prolixa e Vaga) | Regra Cirúrgica OKAM (Densidade Máxima) | |---|---|---| | Linguagem de Código | "Gostaria que o código fosse escrito preferencialmente em JavaScript moderno sem frameworks pesados." | Stack: JavaScript Vanilla ES6+. Proibido uso de frameworks ou bundlers. | | Idioma do Projeto | "Tente escrever as coisas em português para que o time aqui do Brasil consiga entender bem." | Idioma: Nomes de variáveis em inglês; documentação e comentários em PT-BR. | | Escopo de Alteração | "Por favor, não saia mudando arquivos que não foram combinados na nossa conversa." | Escopo: Toque apenas nos arquivos declarados na task. Zero alterações não relacionadas. |

5. Armadilhas Comuns e Como Evitar

[!TIP]

Deixar Regras Conflitantes no Mesmo Documento: Um erro sutil ocorre quando você atualiza o AGENTS.md adicionando uma regra nova no final sem remover uma regra antiga que diz o oposto no início. Diante de duas ordens contraditórias, a IA escolherá aleatoriamente uma delas. Mantenha seu documento enxuto e faça uma leitura de ponta a ponta sempre que adicionar novas diretrizes.

Exercício Prático

Vamos praticar a refatoração de regras vagas para o formato cirúrgico de alta densidade:

1. Analise os três exemplos abaixo:

Frase A: "Seria legal se você pudesse sempre avisar onde cada comando deve ser rodado antes de colocar o código."
Frase B: "Tente não inventar bibliotecas que precisam de instalação porque eu não sei instalar pacotes complexos."
Frase C: "Quando tiver um erro na página, não precisa pedir desculpas nem falar muito, só explica o problema."

2. Reescreva cada uma em formato telegráfico cirúrgico:

Linha A: Comandos: declare sempre 'No [Terminal]:' antes do bloco de código.
Linha B: Dependências: proibido instalar pacotes externos via npm/pip. Use recursos nativos.
Linha C: Tom: telegrafíco e profissional. Sem pedidos de desculpa ou saudações prolixas.

3. Incorpore ao seu AGENTS.md: Adicione essas três linhas à seção de princípios do seu projeto e observe a clareza imediata das respostas nas próximas tarefas.

Escrevendo Regras Cirúrgicas: Máxima Densidade por Token