Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

As anotações já estabelecem comportamento somente-leitura, idempotente e não destrutivo. A descrição agrega lógica operacional: calcula um teto de 5% e uma restituição corrigida, além de expor a tese jurídica de cartão rotativo vendido como consignado que nunca amortiza. Isso é contexto comportamental útil além das anotações.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Is the description appropriately sized, front-loaded, and free of redundancy?

A descrição é concisa e começa pelo acrônimo e escopo INSS; a cláusula da tese acrescenta contexto jurídico relevante de forma compacta. Perde um ponto por usar jargão técnico/abreviações que podem exigir decodificação, mas não há filler.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Para um cálculo com cinco parâmetros, schema sem descrição de parâmetros e sem schema de saída, a descrição é insuficiente. Deixa sem explicação o mapeamento dos parâmetros, o formato do retorno e a escolha entre esta e outras ferramentas de cálculo INSS.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

A cobertura de descrição do schema é 0%, então a descrição deveria explicar os parâmetros, mas apenas alude a 'descontos' e ao limite de 5%. Não explica tipo (RMC vs RCC), indice (qual índice de correção e como é aplicado), data_calculo, beneficio_mensal ou os campos obrigatórios competencia/valor dentro de descontos.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Does the description clearly state what the tool does and how it differs from similar tools?

A descrição identifica um domínio de cálculo específico — RMC/RCC, reserva de margem consignável de cartão com códigos INSS 217/268 — e explicita os dois resultados calculados: limite de 5% e restituição corrigida dos descontos. É clara, mas não usa um verbo explícito como 'calcula' e não diferencia a ferramenta de irmãs próximas como calculo_restituicao_inss.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Does the description explain when to use this tool, when not to, or what alternatives exist?

O escopo é claramente delimitado a casos RMC/RCC com códigos INSS 217/268, o que permite ao agente reconhecer quando a ferramenta se aplica. No entanto, não há exclusões nem comparação explícita com ferramentas irmãs relacionadas, como calculo_restituicao_inss ou calculo_revisional.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.