warn-before-the-thing-you-are-warning-about
Um alerta colocado depois da ação a que se refere chega quando o leitor já decidiu. Ponha-o acima e, quando importa, torne-o impossível de dispensar.
Conferida por quem revisou e leu o cartão, não reivindicada pelo próprio arquivo. Um cartão que o agente destila durante uma execução que consumiu conteúdo não confiável nasce contaminado e fica retido para revisão antes de alguma vez ser recuperado.
Quando ele vem à mente
- escrevendo uma página de download
- adicionando uma ação destrutiva
- documentando uma armadilha
- onde colocar esse aviso
Evite e Verifique são onde costuma estar o valor. Faça é a seção que todo mundo escreve.
O corpo do cartão acima é uma tradução. O original em inglês é o que a CLI importa, o que o agente lê em execução e o que o hash abaixo atesta.
Gatilho
Algo que um usuário está prestes a fazer tem uma consequência que ele não vai esperar: um instalador não assinado que o sistema operacional vai bloquear, um comando que reescreve o histórico, uma configuração que remove um humano de um loop, uma exportação que sai da sandbox.
Não se aplica a consequências óbvias a partir do rótulo. "Excluir" não precisa de um parágrafo explicando que exclui.
Faça
- Coloque o aviso acima do controle, na ordem de leitura, não abaixo dele e não numa tooltip.
- Diga o que vai acontecer nos termos do usuário — o texto exato do diálogo que ele vai ver, o erro exato — e depois o que fazer a respeito.
- Reserve a interrupção para o irreversível. Uma confirmação numa ação de menor alcance treina as pessoas a clicar direto pela confirmação que realmente importa.
- Se a surpresa é inevitável e benigna, explique por que ela acontece. "Não há certificado de assinatura de código" converte um diálogo alarmante num diálogo esperado.
Evite
Avisos depois do botão, avisos numa seção recolhida, e avisos que o usuário pode dispensar antes de sequer ter encontrado a situação. Os três são a mesma falha: a informação chega depois da decisão.
Evite vagueza que soa responsável. "Use com cautela" não diz ao leitor nada sobre o que fazer, e sua função real é proteger o autor, não o usuário.
Evite avisar sobre tudo. Uma página em que cinco coisas estão sinalizadas não sinalizou nada, e o único item genuinamente perigoso agora está camuflado.
Verifique
Leia a página de cima a baixo como alguém que nunca a viu, e pare no momento em que você clicaria. O aviso estava acima desse ponto?
Depois verifique o inverso: conte os avisos na superfície. Se houver mais de um em destaque, decida qual é o real e rebaixe os demais.
Risco
Colocar os avisos logo no início faz a página parecer mais pesada e pode espantar um usuário para quem o risco nunca foi real. Esse custo é genuíno e só vale a pena pagar onde a surpresa também é genuína.
O modo de falha de aplicar isso em excesso é um produto que soa nervoso consigo mesmo. Se toda tela abre com um aviso legal, os avisos viram enfeite (chrome) e o leitor passa direto por eles — o que te devolve ao ponto de partida, só que com um texto pior.
Como usar
O cartão é dado. Clone o repositório e importe pelo caminho — o que chega pela rede é tratado como contaminado e fica retido para aprovação, que é o comportamento desejável e a razão de não haver um instalador de uma linha aqui.
git clone https://github.com/brcampidelli/chimera-agent.gitchimera skills-import chimera-agent/skills/warn-before-the-thing-you-are-warning-about/SKILL.mdIntegridade
SHA-256 do arquivo como publicado. Quem importa pode conferir que o que recebeu é o que esta página mostrou.
6406dae5aafa466bdccc3cea9496b6beb40fee9c87b13da623f55e07fc526182