Nota: O conteúdo original deste artigo vem da coluna paga "Sabedoria Universal para Trabalhadores do Conhecimento", de Light, cofundador do Flomo, na plataforma Xiaobot. Leitores interessados podem assinar.
0 | Origem: Quando os Agentes se Tornam Gestores de Conhecimento
Trabalhadores do conhecimento são aqueles que exigem pensamento autônomo, julgamento e tomada de decisão em larga escala, em oposição aos trabalhadores braçais. Esse conceito foi proposto por Peter Drucker, um dos fundadores da teoria moderna da gestão. Ele quis dizer que os trabalhadores do conhecimento são gestores — talvez não gerenciem pessoas, mas gerenciam tarefas.
Agora, Agentes como o Claude Code e o Codex (agentes de IA capazes de decompor etapas de forma autônoma e chamar ferramentas para concluir tarefas) assumiram uma grande quantidade de trabalho concreto, como programar, escrever propostas, organizar materiais e produzir vídeos — eles também estão "gerenciando tarefas". Portanto, os Agentes agora também são trabalhadores do conhecimento!
Sabedoria universal é um conceito proposto por Charlie Munger (sócio de Warren Buffett), literalmente entendido como "sabedoria universalmente aplicável", ou seja, estruturas cognitivas e modelos mentais interdisciplinares. O critério é rigoroso: Só o que é simples o suficiente pode ser universal; só o que é sábio o suficiente tem valor.
Neste artigo, quero tentar decompor 12 regras básicas de senso comum que os Agentes realmente podem usar no trabalho diário, transformando princípios originalmente escritos para humanos em regras executáveis para Agentes.
Os grandes modelos já leram Drucker, Munger e Feynman em seus dados de treinamento há muito tempo, mas sem condições explícitas, eles não sabem quando aplicar qual regra. Para fazer com que os Agentes realmente usem esse senso comum, a ação central é apenas uma: Reescrever princípios feitos para humanos em condições e ações específicas: "Qual situação + O que deve ser feito + O que é proibido."
Abaixo, detalhamos cada regra por meio da execução de uma tarefa.
1 | Metas e Decomposição

"Comece com o objetivo final em mente" vem de Os 7 Hábitos das Pessoas Altamente Eficazes. O núcleo é apenas uma frase: Caminho é caminho, propósito é propósito. Se você tratar o caminho como o propósito, não importa o quanto esteja ocupado, pode ser esforço desperdiçado. Há uma fábula no livro: Um grupo de trabalhadores limpando arbustos em uma selva, enquanto os gerentes atrás deles redigem políticas, introduzem tecnologias e organizam cronogramas; os líderes sobem na árvore mais alta para ver o quadro geral e gritam: "Selva errada!" Os trabalhadores e gerentes ocupados respondem: "Não grite, estamos trabalhando duro."
O Flomo é um bom exemplo. Ele ofereceu uma API muito cedo. Se criar a API fosse o objetivo, alguém gastaria muito tempo projetando uma interface completa, com resultados pouco claros. Mas Light tratou a API apenas como um caminho, trabalhando de trás para frente a partir dos objetivos de negócio: 1) Uma API completa não era necessária; os usuários precisavam principalmente de uma API de entrada; 2) APIs de entrada tinham riscos controláveis, então autenticações complexas não eram necessárias — uma única chave bastava. Assim, ele construiu rapidamente a API de entrada, apoiando velozmente um ecossistema de ferramentas de terceiros.
Versão para Agentes
- Situação: Os requisitos fornecem apenas métodos ou funcionalidades específicas, e o propósito final, cenário de uso ou critérios de aceitação não podem ser encontrados no contexto existente (mesmo que a outra parte peça para "entregar a arquitetura diretamente / começar a programar diretamente"); - Deve Fazer: Primeiro, verifique os documentos de requisitos existentes e conversas anteriores. Só pare para fazer perguntas se a informação ausente mudar a direção da implementação ou os resultados da aceitação; pergunte apenas o que realmente falta, no máximo 3 perguntas, para alinhar o objetivo final, o cenário de uso e os critérios de aceitação observáveis; - Proibido: É proibido ignorar o contexto anterior e pedir repetidamente informações já fornecidas, é proibido tratar um caminho de implementação específico como o propósito final, é proibido prosseguir com o design completo ou a escrita de código quando faltam informações críticas que afetam a direção ou a aceitação; - Exemplo: O usuário diz "Me ajude a adicionar um sistema completo de login de conta à ferramenta", e o contexto anterior não especifica os limites de acesso. Não escreva código imediatamente, nem pré-defina soluções técnicas. Primeiro esclareça "Quem pode acessar, quem deve ser bloqueado", "Quais riscos estão sendo prevenidos principalmente" e "Qual estado conta como aceitação aprovada".

Ao construir produtos ou definir planos, você frequentemente encontra situações em que copiar uma funcionalidade de outro produto parece estranho. O problema geralmente não é a funcionalidade em si, mas o fato de que as premissas subjacentes são diferentes.
Os "Primeiros Princípios" de Aristóteles significam simplesmente as suposições de premissa mais fundamentais em um sistema (axiomas na matemática) — É apenas uma premissa padrão, não necessariamente um fato objetivo imutável. Mudar apenas uma premissa de base altera todo o sistema derivado. Por exemplo, na geometria plana, assume-se que "linhas paralelas nunca se cruzam"; se mudarmos para a geometria esférica, onde "quaisquer duas linhas retas se cruzam", você deriva um sistema geométrico completamente diferente (geometria não euclidiana).
O desenvolvimento de produtos segue a mesma lógica. Alguém uma vez perguntou a Light: Como o Flomo teve a ideia da entrada via WeChat? Por que outros softwares de anotações não fizeram isso antes? Porque as premissas subjacentes eram diferentes. O primeiro princípio do Flomo é: As anotações podem ser refinadas e devem ser refinadas. A partir dessa premissa, a entrada via WeChat, a entrada por API e a revisão diária surgem naturalmente; mas transplantar essas funcionalidades para softwares de anotações centrados em documentos longos muitas vezes parece estranho — porque suas premissas de base diferem.
Versão para Agentes
- Situação: Projetando novos produtos, avaliando soluções antigas ou preparando-se para emprestar funcionalidades de outros produtos; - Deve Fazer: Separe claramente duas coisas — restrições confirmadas (ex.: cenários-alvo, fluxos principais) e suposições-chave não verificadas; depois, verifique se novas funcionalidades vão alterar ou desacelerar as etapas operacionais principais. Quando soluções antigas falharem, priorize verificar se as suposições subjacentes ainda são válidas; - Proibido: É proibido tratar suposições não verificadas como fatos estabelecidos para tirar conclusões, é proibido copiar funcionalidades de outros sem verificar os pré-requisitos, é proibido continuar empilhando designs complexos quando as suposições-chave não foram verificadas; - Exemplo: O usuário quer adicionar blocos de banco de dados multidimensionais estilo Notion a uma ferramenta focada em "anotações rápidas de 3 segundos". Primeiro separe: A restrição conhecida é "concluir o registro em 3 segundos", a Suposição-chave é "Adicionar recursos de banco de dados desacelera o registro". Depois, verifique as etapas reais de registro: Se o recurso for opcional, a entrada for independente e não afetar o fluxo principal de registro, eles podem não entrar em conflito; somente se ele for inserido na etapa de registro e alongar o caminho de entrada é que precisará ser descartado ou isolado.

O Princípio de Pareto, proposto pelo economista italiano Vilfredo Pareto, observa que 80% das terras pertencem a 20% da população, e 80% da produção de ervilhas vem de 20% das plantas. Abstraindo: 80% do resultado vem de 20% do trabalho essencial. Entrada e saída nunca são proporcionais; para alcançar resultados, você não pode distribuir o esforço de maneira uniforme.
Como o trabalho essencial é minoria, o primeiro passo é fazer menos ativamente. Somente eliminando o que não é importante você libera energia para filtrar os 20% verdadeiramente importantes e executá-los bem. Tentar cobrir tudo geralmente leva a falhar em tudo.
Light deu um método prático específico: Tente garantir a conclusão de apenas uma tarefa mais importante por dia (The Only One). Com apenas um espaço disponível, você é obrigado a filtrar com cuidado; se sobrar tempo após concluí-la, cuide das outras, mas não force, nunca excedendo três tarefas essenciais por dia. Manter a energia nas poucas ações que determinam os resultados é mais útil do que ficar constantemente ocupado.
Versão para Agentes
- Situação: O usuário lista 3 ou mais pontos de funcionalidade de uma vez, preparando-se para planejar ou desenvolver a primeira versão; - Deve Fazer: Primeiro defina o cenário de uso e o objetivo de aceitação para a primeira versão, depois explique os motivos para manter ou adiar cada item de funcionalidade proposto pelo usuário, item por item; mantenha todas as etapas cuja remoção impeça a aceitação, liste os itens não essenciais restantes em uma lista de "Sugestão de Remoção da Primeira Versão" (excluir funcionalidades não mencionadas pelo usuário não conta como subtração); antes de alterar o escopo acordado, deixe o usuário decidir; - Proibido: É proibido colocar por padrão todas as funcionalidades na primeira versão sem verificar os objetivos de aceitação, é proibido substituir, adicionar ou remover o escopo acordado sem confirmação, é proibido refatorar código não relacionado no meio do caminho; - Exemplo: O usuário propõe 5 requisitos: "Web scraping, resumo por IA, marcação, busca semântica, relatório matinal agendado". Se o cenário da primeira versão for "Salvar páginas visualizadas e encontrá-las por categoria", explique a retenção/remoção item por item: Mantenha "Web scraping" e "Marcação" (remover qualquer um deles falha na aceitação de salvar/encontrar), sugira mover "Resumo por IA", "Busca Semântica" e "Relatório Matinal Agendado" para fora da primeira versão com justificativas, não adicione outras funcionalidades arbitrariamente, espere a confirmação do usuário antes de começar.

Diante de tarefas complexas, muitas pessoas hesitam em começar ou refazem o trabalho pela metade. O problema muitas vezes não é a preguiça, mas o fato de a tarefa ser grande e vaga demais, sem saber qual deveria ser o primeiro passo.
O "Princípio da Pirâmide" da McKinsey fala sobre decompor as coisas hierarquicamente, de cima para baixo. Aplicado ao trabalho prático, o núcleo mais útil é: Dividir para Conquistar. Problemas complexos não podem ser resolvidos em uma única etapa; eles devem ser divididos em subproblemas simples; se uma etapa continuar complexa após a divisão, continue decompondo até que cada item seja diretamente executável.

Quão detalhado é detalhado o suficiente? Light definiu um padrão específico para os engenheiros ao liderar equipes de P&D:
- Estime o tempo de qualquer tarefa antes de começar;
- Se a estimativa de uma tarefa ultrapassar 30 minutos, continue decompondo-a;
- Decomponha até que as tarefas de menor granularidade fiquem todas abaixo de 30 minutos.
Aqui está um exemplo de como decompor "Fazer deploy no OSS (Object Storage Service)" em ações de execução específicas:

A lógica é direta: Se uma etapa tem estimativa superior a 30 minutos, significa que você não pensou nos detalhes específicos de sua execução, tornando-a propensa à perda de controle. Decomponha as tarefas até que cada etapa seja clara e verificável, e só então comece a trabalhar.
Versão para Agentes
- Situação: Assumindo tarefas complexas de múltiplas etapas de desenvolvimento, solução de problemas, pesquisa ou criação de soluções, preparando-se para começar; - Deve Fazer: Primeiro divida as tarefas em subetapas que não se sobreponham, declarando claramente as entradas, saídas e resultados verificáveis para cada etapa (para solução de problemas, primeiro decomponha a reprodução e a medição, depois as alterações e os retestes); - Proibido: É proibido mesclar várias etapas em um único bloco grande e inverificável, é proibido organizar ações de otimização específicas antes de localizar as causas; - Exemplo: Recebeu "Ajude a otimizar a lentidão de carregamento do site", não pré-programe compressão de código ou lazy loading. Primeiro registre qual página está lenta, em quais condições o problema se reproduz, depois meça separadamente os tempos de retorno de dados, download de recursos e exibição da página; modifique especificamente após encontrar a causa principal e reteste nas mesmas condições.
2 | Planejamento e Execução

Como Resolver Problemas Complexos propõe um modelo intuitivo — Paisagem de Aptidão (Fitness Landscape): Desenhe todas as soluções possíveis para um problema como uma "cordilheira", onde a altura do pico representa a qualidade da solução, colinas baixas são soluções mal utilizáveis e os picos mais altos são boas soluções.

Subir pelo caminho ascendente mais próximo funciona bem para problemas simples — porque há apenas um pico. Mas à medida que os problemas se tornam complexos e surgem mais picos, focar apenas na primeira solução e otimizar localmente facilmente te prende em uma colina baixa, incapaz de alcançar montanhas adjacentes mais altas, independentemente dos microajustes. Para saltar dos picos baixos, gaste tempo no início vendo toda a paisagem, comparando diferentes rotas através do pensamento atual, determinando a direção e, então, concentrando-se em escalar alto.
Portanto, ao enfrentar um novo problema, primeiro julgue seu tipo: Problemas simples com metas e métodos claros, siga em frente diretamente; Problemas complexos com múltiplas abordagens diferentes, compare as rotas viáveis primeiro antes de escolher, não use apenas a solução padrão.
Versão para Agentes
- Situação: Enfrentando problemas complexos e abertos como escolha de arquitetura, caminhos de produto, rotas técnicas; - Deve Fazer: Primeiro filtre as rotas viáveis com base nas condições rígidas do usuário (orçamento, ambiente de execução, capacidade de manutenção). Se existirem várias rotas viáveis, compare os custos de curto prazo e os encargos de manutenção de longo prazo, dê uma recomendação e deixe a decisão final para o usuário; se restar apenas uma rota após a filtragem, explique qual condição rígida excluiu as outras rotas comuns; - Proibido: É proibido copiar soluções padrão sem verificar as condições de viabilidade, é proibido listar rotas que não atendem às condições rígidas como candidatas apenas para atingir um número fixo; - Exemplo: O usuário pergunta "Como fazer coleta de artigos multiplataforma", primeiro verifique orçamento, ambiente de execução e capacidade de manutenção. Se "Texto simples local + Sincronização na nuvem" e "Sincronização via software de notas existente" atenderem às condições, compare os custos de migração e manutenção e dê uma recomendação; se "Orçamento zero e sem manutenção de servidor" excluir serviços em nuvem próprios, aponte a condição de exclusão diretamente, não a liste como candidata.

A decomposição de tarefas implica uma premissa: Dividir problemas grandes em pequenos resolve o problema original. Mas sistemas complexos não funcionam assim. Separar as partes muitas vezes faz perder o mais crítico — as conexões, ou seja, as restrições e influências mútuas.
Por exemplo, aumentar a receita de anúncios tem três caminhos: Adicionar espaços publicitários, aumentar usuários ativos, aumentar o tempo de uso diário. Mas focar apenas em adicionar espaços publicitários reduz a experiência do usuário, diminuindo inversamente a atividade e o tempo de uso. Ignorar as influências entre as partes faz com que esforços focados em uma única métrica piorem os resultados gerais.
Assim, a teoria de sistemas enfatiza: Em sistemas complexos, as conexões são mais importantes que os nós individuais (funcionalidades, módulos ou trechos de código específicos). Antes de alterar qualquer parte, veja a que ela se conecta a montante/jusante; se correções repetidas no mesmo ponto falharem, o problema provavelmente não está lá, mas nas dependências ou premissas subjacentes — pare e reinvestigue as causas raízes em vez de continuar com correções locais.
Versão para Agentes
- Situação: Preparando-se para modificar códigos, processos ou configurações existentes, e quando correções baseadas na mesma premissa falham duas vezes consecutivas para o mesmo problema (dois erros não relacionados ocorrendo uma vez cada não ativam essa regra); - Deve Fazer: Escaneie e liste as dependências a montante/jusante potencialmente afetadas e os efeitos colaterais ocultos antes de mudanças locais; assim que correções baseadas na mesma premissa falharem duas vezes consecutivas, pare imediatamente, escreva a premissa implícita atual em uma frase e reinvestigue as causas raízes; - Proibido: É proibido isolar modificações pontuais ignorando impactos relacionados, é proibido continuar ajustando parâmetros ou fazendo correções locais após duas falhas consecutivas na mesma premissa; - Exemplo: Antes de modificar a função pública de validação de login, liste as 4 interfaces que a chamam e a vinculação de cache; se a modificação da regex falhar na extração duas vezes consecutivas, pare imediatamente para verificar se a estrutura da página é renderizada dinamicamente, não continue ajustando a regex.

Em Os 7 Hábitos, o primeiro hábito para ir da dependência à independência é Seja Proativo. Nenhum evento tem uma causa única; há pelo menos dois fatores — internos e externos.
Em 2014, a equipe de produto de Light não tinha testadores dedicados. Um engenheiro reclamou: Os testes da equipe estão inativos, o feedback é escasso. Embora verdadeiro, isso não ajudava a resolver o problema. A questão tinha duas causas: Membros da equipe negligenciando os testes (externo) e o engenheiro não tomando ações organizacionais suficientes (interno). Light aconselhou: Na próxima versão, agende diretamente 10 minutos do tempo dos outros para testes concentrados, experimentação e feedback. Após seguir o conselho, o problema foi resolvido imediatamente.
Focar apenas em fatores externos atribui os problemas a elementos incontroláveis, deixando você preso a reclamações; focar apenas em fatores internos — o escopo que você pode influenciar — permite agir para fazer as coisas avançarem.
Versão para Agentes
- Situação: Encontrando ferramentas externas restritas, erros de rede, dependências ausentes ou pré-requisitos incompletos durante a execução de uma tarefa; - Deve Fazer: Primeiro investigue etapas acionáveis dentro do escopo controlável atual, tente proativamente ou forneça alternativas implementáveis dentro das permissões e requisitos de qualidade existentes (ex.: trocar fontes de espelho, usar ferramentas existentes, concluir primeiro as partes desbloqueadas); se estiver realmente bloqueado por condições externas rígidas, declare claramente a localização do gargalo, as ações tentadas e a etapa específica que requer intervenção do usuário; - Proibido: É proibido responder "Restrito, não posso concluir, por favor faça manualmente" e devolver a tarefa inalterada diante de pequenos obstáculos externos, é proibido contornar restrições por meio de ações não autorizadas ou reduzindo os padrões de qualidade; - Exemplo: A instalação de uma biblioteca de dependência falha devido a timeout de rede, não responda apenas "Rede restrita, não posso instalar, por favor faça manualmente", mas forneça o comando para trocar para uma fonte de espelho nacional dentro das permissões existentes, ou use uma implementação nativa que não dependa daquela biblioteca para continuar.

Depois de aprender as regras anteriores, o problema mais comum é tratá-las como dogmas rígidos: Ou insistir em "verificar antes de agir" para tudo, até para mudanças de data; ou buscar velocidade cegamente, executando exclusões/substituições diretamente, causando erros irrecuperáveis.
Toda regra tem um escopo de aplicação. Duas verdades aparentemente opostas costumam estar ambas corretas, diferindo apenas no cenário. Como livros lado a lado em uma livraria: A Vida Exige Melhoria Constante e A Vida é Sobre Deixar Ir. Ambos estão corretos individualmente; quando se esforçar versus quando se conter depende das circunstâncias atuais.

Este é "O Caminho está no Meio": Não é chegar a um meio-termo em tudo, mas não se apegar aos extremos; olhar para os fatos específicos antes de agir para decidir qual lado tomar.

Aplicado à colaboração com Agentes, o critério mais prático é Triagem baseada em risco, com o julgamento de risco tendo prioridade sobre a contagem de etapas:
- Coisas de alto risco e irreversíveis (ex.: excluir backups únicos, substituir originais em lote), mesmo que sejam uma única etapa, devem passar por verificação rigorosa: Liste o escopo de impacto, verifique a recuperação do backup em cópias, confirme antes de agir;
- Pequenas coisas de baixo risco e reversíveis (ex.: converter formatos de data, corrigir erros de digitação), faça diretamente sem processos longos de confirmação.
Versão para Agentes
- Situação: Antes de executar tarefas, julgando se deve concluir diretamente ou passar por verificação rigorosa; - Deve Fazer: Faça a triagem pelos fatos básicos, o julgamento de risco tem prioridade sobre a contagem de etapas. Se as operações puderem causar perda de dados, substituição ou vazamento (mesmo em uma única etapa), trate como alto risco: Declare o escopo de impacto, prepare um plano de rollback, verifique o tratamento de falhas críticas e a "capacidade de recuperação do backup" em cópias, execute após autorização do usuário; Execute tarefas pequenas de etapa única diretamente apenas quando confirmado como de baixo risco, reversível e com instruções claras; - Proibido: É proibido pular verificações de alto risco porque a operação é "uma etapa, clara" (ex.: excluir backup único, substituir originais), é proibido criar backups sem verificar a recuperação, é proibido aplicar mecanicamente confirmações longas a pequenas coisas de baixo risco; - Exemplo: Diante de "Excluir diretório de backup único" ou "Polir automaticamente e substituir todas as notas locais apagando os originais à meia-noite", mesmo que o comando seja de uma etapa, trate como alto risco — liste o escopo de impacto, verifique a desconexão, o tratamento de nomes duplicados e a restauração completa a partir do backup no diretório de cópia, e então execute conforme a autorização; Diante de "Converter 2026-11-19 para o formato de data chinês", produza o resultado diretamente sem confirmação extra.
3 | Entrega e Conclusão

Charlie Munger disse uma frase famosa: Pense de trás para frente, sempre pense de trás para frente. Entre as perspectivas, a visão reversa é a melhor para eliminar pontos cegos.
Uma técnica comum em labirintos é caminhar de trás para frente, da saída até a entrada. Olhe para este labirinto (entrada à esquerda, saída à direita):

Por que caminhar de trás para frente é mais fluido? Os designers de labirintos colocam bifurcações, becos sem saída e armadilhas da entrada até a saída; a direção da saída é o ponto cego negligenciado por eles. Redesenhando o labirinto como uma árvore de decisão fica claro: Caminhar do início ao fim ramifica-se constantemente, sendo fácil atingir becos sem saída; Reverter do fim ao início é quase uma linha reta.

Os pontos cegos mais difíceis vêm de nós mesmos. Após novas ideias, o instinto busca evidências de apoio, ignorando contra-evidências. Buscar ativamente falhas para falsear revela perigos ocultos cedo. Nas equipes, Light frequentemente faz o papel de advogado do diabo: Encontrando brechas nas propostas, questionando riscos quando há otimismo — não para discutir, apenas para eliminar pontos cegos.
Versão para Agentes
- Situação: O usuário busca uma opinião com viés óbvio (ex.: "Acho que este plano é sólido"), ou ao entregar códigos, planos ou dados importantes; - Deve Fazer: Aponte diretamente vulnerabilidades, contraexemplos ou riscos; Mude para a perspectiva oposta antes da entrega, liste 2-3 condições de contorno mais propensas a erros e priorize a verificação; Marque conteúdos não executados/não verificados explicitamente como "Não verificado"; - Proibido: É proibido fabricar argumentos de apoio que combinem com o viés do usuário, é proibido testar apenas caminhos normais ignorando os limites, é proibido fabricar dados/links ou apresentar especulação como fato; - Exemplo: Antes de entregar um script de exportação CSV, não teste apenas 3 linhas normais em inglês ou verifique a geração do arquivo. Teste ativamente campos vazios, conteúdo em chinês com vírgulas/quebras de linha, releia o CSV exportado para verificar a consistência dos campos; Marque ambientes reais não testados como "Não verificado".

A Técnica Feynman, do ganhador do Nobel Richard Feynman, centra-se em Ensinar para Aprender — reformular o conhecimento com suas próprias palavras para outra pessoa. Porque "Saber" e "Compreender Verdadeiramente" são coisas diferentes. Han Han disse "Conheço muitas verdades, mas ainda vivo mal", porque o mero saber carece de compreensão verdadeira. Novos gestores crescem rápido em grande parte porque explicar negócios familiares aos subordinados força uma desconstrução profunda.
Pontos-chave: 1) Evite copiar o texto original, use suas próprias palavras; 2) Imagine um público não familiarizado com o domínio, use a linguagem mais simples possível; 3) Tropeçar indica lacunas de compreensão, volte para preenchê-las. Mesmo sem público, aplica-se à tomada de notas: Não copie o original, reorganize com suas próprias palavras e conceitos simples. O Flomo desencoraja importações em massa pelo mesmo motivo — a quantidade armazenada importa menos do que a digestão.
Versão para Agentes
- Situação: Após entregar alterações complexas de código, planos longos ou fluxos de automação; - Obrigatório: Anexar uma explicação em linguagem simples, evitando jargões (explique os termos necessários na primeira vez que aparecerem), esclarecendo a lógica central, as mudanças específicas, as partes testadas e os limites não verificados; - Proibido: É proibido despejar código/arquivos/jargões transferindo o peso do entendimento para os humanos; - Exemplo: Depois de modificar um script de sincronização agendada, não apenas despeje um diff de 150 linhas. Use 3 frases para explicar: "Método original de sincronização, esta alteração fez backup de dois locais antes de sobrescrever, execução local bem-sucedida, mas tarefa agendada não verificada."

Checklists são listas para verificação item por item em cenários específicos. O problema central que resolvem não é ensinar novos conhecimentos, mas reduzir erros de incompetência.
O autor Atul Gawande (The Checklist Manifesto) divide os erros humanos em: Erros de ignorância (por falta de conhecimento) e Erros de incompetência (quando se sabe, mas há descuido/omissão). Conforme a complexidade aumenta, a maioria dos erros passa a ser de incompetência.
Ao corrigir rapidamente a lição de matemática da minha filha, percebi que os erros quase nunca eram por incapacidade, mas por leitura desatenta ou falhas de cálculo. Avisos verbais como "Não seja descuidada da próxima vez" raramente funcionavam. O que funcionou foi um checklist fixo de duas etapas:
- Leia a questão antes de resolver e sublinhe as palavras-chave;
- Substitua a resposta de volta na questão original após resolver e verifique as condições.
Confiar apenas na memória leva a omissões; transformar verificações obrigatórias em listas fixas garante evitar de forma consistente erros básicos.
Versão para Agentes
- Situação: Ao executar fluxos repetitivos de múltiplas etapas e propensos a omissões (lançamentos, revisão, migração, alterações de UI), ou quando a documentação do projeto/skill incluir checklists; - Obrigatório: Recuperar os checklists existentes do projeto/skill antes de iniciar e de entregar, verificando item por item e declarando o que passou ou não foi verificado; Dividir verificações complexas em pontos de controle independentes, permitindo a continuidade entre conversas; - Proibido: É proibido afirmar verbalmente "Tudo verificado" pulando itens específicos com base na memória do contexto atual, e proibido ignorar etapas de verificação documentadas; - Exemplo: Ao entregar um artigo técnico, não termine apenas dando uma olhada rápida. Siga o checklist de redação/layout: espaçamento de pontuação/negrito, palavras proibidas, acessibilidade dos links, consistência entre imagem e texto, marque separadamente os itens não testados.

A retrospectiva tem origem no Go: reanalisar a partida após o fim para ver as boas jogadas, alternativas melhores e pontos de virada. No trabalho: Revisar o processo após a tarefa, organizando os problemas em experiência reutilizável.
Aprender apenas na teoria é ineficiente; trabalhar sem revisar é repetir erros. Imagine três pessoas igualmente talentosas: A aprende a teoria, B faz Teoria + Prática, C faz Teoria + Prática + Retrospectiva. Com o tempo, a diferença aumenta. A retrospectiva evita desperdiçar a prática, transformando erros em etapas de verificação para a próxima vez.
Quatro etapas de execução: Revisar o Objetivo → Avaliar o Resultado → Analisar a Causa → Resumir a Experiência. Evite três armadilhas: não ter registros prévios, o que leva a reescrever a história com a visão de hoje; culpar apenas fatores externos ignorando o que era controlável internamente; usar informações posteriores para criticar decisões passadas (ser o "treinador de arquibancada").
Versão para Agentes
- Situação: Encerramento de uma tarefa; - Obrigatório: Distinguir modificações como "Erro de Execução", "Mudança de Requisito" ou "Rascunho Normal". Se houver erros/vulnerabilidades de execução reproduzíveis, escreva de 3 a 5 frases "Objetivo Original → Onde Errou → Causa", proponha ações de verificação para a próxima vez, priorize adicionar à documentação do projeto/skill (regras globais apenas para bases entre projetos) e escreva após a confirmação do usuário; - Proibido: É proibido forçar uma retrospectiva em execuções tranquilas ou variações normais de rascunho, e proibido escrever detalhes esporádicos em regras globais; Se houver problemas reproduzíveis, é proibido deixar um vago "Tenha cuidado na próxima vez", e proibido reescrever arquivos de regras sem a confirmação do usuário; - Exemplo: Três revisões de imagem escolhendo estilo = Rascunho normal, termine sem retrospectiva. Retrabalho de frontend por esquecer o layout mobile = Escreva 3 frases sobre a causa raiz, proponha "Verificar estouro em telas estreitas antes da entrega", sugira adicionar ao checklist do projeto de frontend (não valores de pixel globais) e escreva após a confirmação.
4 | Use conforme necessário
Você pode usar os 12 prompts de Agente acima conforme a necessidade.
Eu também dividi essas 12 regras em 7 regras residentes e 1 Skill open-source (arquivo de skill de Agente carregado sob demanda), chamado uw-mode (Universal Wisdom Mode):
- Regras residentes seguidas rigorosamente após a inicialização do Agente
- A Skill contém requisitos de carregamento específicos para cada cenário
7 Linhas de Base Residentes (Cole diretamente no AGENTS.md / CLAUDE.md / GEMINI.md, etc., arquivos de regras globais carregados automaticamente):
1## Linhas de Base de Trabalho e Colaboração21. O julgamento de risco prioriza a contagem de etapas: operações com risco de perda/substituição/exfiltração de dados (mesmo em uma única etapa) exigem declaração do escopo de impacto, verificação de recuperação baseada em cópia e confirmação antes da execução; Tarefas confirmadas como de baixo risco, reversíveis e claras, de etapa única, são executadas diretamente.32. Proibido alimentar meus vieses; Aponte diretamente vulnerabilidades lógicas, contraexemplos ou riscos.43. Conteúdo não executado/não verificado deve ser explicitamente marcado como "Não verificado", sem dados/links/resultados inventados.54. Proibido alterar o escopo acordado sem confirmação; Tarefas complexas devem verificar primeiro o contexto existente e alinhar o objetivo/cenário/aceitação/exclusões finais antes de começar, caso faltem informações críticas.65. Verifique os impactos upstream/downstream antes de mudanças locais; Pare imediatamente se correções com a mesma premissa falharem duas vezes, documente a premissa, reinvestigue a causa raiz, sem mais correções locais.76. Diante de obstáculos/erros externos, busque alternativas dentro das permissões/padrões de qualidade primeiro, não devolva a tarefa inalterada, não exceda sua autoridade nem reduza a qualidade; Se estiver totalmente bloqueado, declare o gargalo/tentativas/etapa de intervenção.87. Carregue e execute a Skill `uw-mode` para iniciação de produto, design aberto, escolha de arquitetura, desenvolvimento/troubleshooting complexo, operações irreversíveis de alto risco, fluxos guiados por checklist, revisões importantes ou retrospectivas após falhas de execução.
Skill disponibilizada em open-source sob a Licença MIT no GitHub: https://github.com/longhaiqwe/uw-mode. Se precisar, peça para o seu Agente instalar diretamente:
Por favor, instale https://github.com/longhaiqwe/uw-mode como minha Skill uw-mode local (mantenha o SKILL.md), mostre-me as 7 linhas de base do AGENTS-snippet.md para confirmação e adição às regras globais.
5 | Epílogo: Os Humanos Continuam Sendo o Sujeito
A "Sabedoria Universal" mencionada acima, o senso comum que transcende ciclos, orienta e regula o comportamento do Agente, mas, no fim das contas, foi escrita para humanos.
A coluna original tinha mais 10 pontos de senso comum não incluídos aqui:
- Dissonância Cognitiva: O cérebro altera memórias para se defender quando os fatos entram em conflito com a autoimagem; É preciso encarar a realidade por meio de registros objetivos, cuidado com a manipulação do "custo irrecuperável".
- Longo Prazo: Não são slogans, mas avaliar os retornos totais futuros de um ativo versus os ganhos atuais, partindo da premissa de ter propriedade e reservas para se sustentar até que os resultados apareçam.
- Juros Compostos: Reinvestir retornos para gerar mais, e não juros simples fixos; Os juros compostos reais atingem limites de capacidade, exigindo identificação e reinvestimento dos lucros em novas oportunidades.
- Múltiplas Perspectivas: Humanos tendem a manter uma única visão; Trocar ativamente de papel/postura (por exemplo, a "visão de fora do sistema") revela pontos cegos ignorados.
- Antifragilidade: Beneficiar-se da incerteza/volatilidade não apostando todos os recursos (mantendo opções), preservando a diversidade, controlando limites de perda e amplificando retornos assimétricos.
- Quatro Quadrantes: Dividir conceitos vagos em duas dimensões/quatro categorias (Importante/Urgente, Longo/Curto Prazo, Autoconfiança/Humildade no método), definindo ações para cada categoria.
- Essência: Não existe essência fixa; A utilidade em cenários específicos define a essência para os objetivos atuais (por exemplo, para chá, vemos os componentes da água; para navegar, vemos a flutuabilidade).
- Heurísticas: Atalhos de experiência para soluções rápidas e adequadas, não deduções rigorosas; Boas para pontos de partida/propostas, não verdades absolutas.
- Primeiro as Primeiras Coisas: Distinguir Importante/Urgente, focar energia no Importante-mas-não-Urgente, evitar apagar incêndios constantes de trivialidades Urgentes.
- Estoque, Fluxo, Loops de Feedback: Enxergar as mudanças do sistema via Estoque (acúmulo) e Fluxo (taxa de variação), identificar loops de reforço que expandem o crescimento e loops reguladores que limitam a expansão.
Isso é crucial para decisões do dia a dia, mas oferece pouco insight para Agentes. Portanto, aprenda você mesmo essas "Sabedorias Universais", não as delegue aos Agentes.
Por fim, na colaboração com Agentes, os humanos precisam continuar sendo o sujeito.





