Esforço de raciocínio
O controle de esforço ajusta quanto trabalho de raciocínio a sessão pode dedicar antes da resposta final.
Aumente quando
- Há muitas dependências ou arquivos envolvidos.
- O pedido exige planejamento e revisão em várias etapas.
- Um erro pode ter causas menos óbvias.
Não aumente por hábito
Uma alteração simples fica mais eficiente com um esforço proporcional. O melhor nível é o menor que ainda oferece qualidade suficiente para a tarefa.
Esforço é orçamento
Low, Medium, High, Extra e Max controlam quanto trabalho interno é dedicado à tarefa. Mais esforço não significa automaticamente melhor resultado.
- Aumente o nível quando dependências, regressões ou custo de reversão deixam de ser locais.
O que merece atenção
Use Esforço de raciocínio como uma referência de operação, não como uma tela isolada. A própria proposta da página é: O controle de esforço ajusta quanto trabalho de raciocínio a sessão pode dedicar antes da resposta final. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.
Se o comportamento divergir do esperado, separe falha visual, falha de dados e falha de execução. O objetivo é descobrir em qual etapa de Esforço de raciocínio o estado deixou de corresponder ao que a interface prometia.
No Giorgio Code, isso também significa distinguir o que foi apenas proposto, o que foi escrito em arquivo e o que foi realmente executado ou verificado.
- confirme o estado antes de iniciar a próxima ação
- mantenha arquivos, sessão e contexto ligados ao mesmo objetivo
- trate mensagens de erro como dados de diagnóstico, não como detalhe visual
Um fluxo que funciona
Comece por “Aumente quando”, confirme o estado visível e avance para “Não aumente por hábito” apenas quando a etapa anterior estiver estável. Em Esforço de raciocínio, pular contexto costuma gerar mais retrabalho do que velocidade.
Quando mudar de estratégia
Imagine uma tarefa real em que Esforço de raciocínio deixa de ser uma opção de menu e passa a decidir a qualidade da entrega. Faça uma primeira passagem curta, observe o retorno do sistema e só então aumente escopo, quantidade de arquivos ou duração da sessão.
Nem todo caso precisa da configuração mais avançada. Prefira o caminho mínimo que resolve o objetivo e aumente complexidade somente quando Esforço de raciocínio realmente exigir mais contexto, controle ou verificação.
- trate mensagens de erro como dados de diagnóstico, não como detalhe visual
- revise a saída no mesmo ambiente em que ela será usada
- confirme o estado antes de iniciar a próxima ação
Sinais de que terminou
Se o comportamento divergir do esperado, separe falha visual, falha de dados e falha de execução. O objetivo é descobrir em qual etapa de Esforço de raciocínio o estado deixou de corresponder ao que a interface prometia.
Use Esforço de raciocínio como uma referência de operação, não como uma tela isolada. A própria proposta da página é: O controle de esforço ajusta quanto trabalho de raciocínio a sessão pode dedicar antes da resposta final. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.
Checklist de integração: Esforço de raciocínio
Nesta página, a referência completa cobre Low, Medium, High, Extra, Max, adaptação e orçamento de verificação. O objetivo não é decorar nomes de controles; é entender entradas, estado, efeitos colaterais, falhas recuperáveis e a evidência que confirma a conclusão.
- confirme o estado inicial antes de executar a ação
- identifique quais dados ou arquivos a superfície realmente possui
- trate loading, vazio, erro, retry e reentrada como comportamento principal
- verifique o resultado no mesmo contrato que o usuário consegue observar
Casos de borda de Esforço de raciocínio
A versão robusta desta função continua coerente quando a rede atrasa, a sessão muda, o conteúdo está vazio, o usuário repete a ação, o viewport encolhe ou uma dependência externa deixa de responder. Esses estados fazem parte da documentação porque também fazem parte do produto.
