banger-explainer

Banger Explainer — conteúdo de ensino que sobrevive ao compartilhamento

O conteúdo de ensino falha em duas direções. Com muita voz, o leitor aprecia, mas não consegue repetir. Com muita especificação, parece documentação que ninguém compartilha. Este procedimento atribui cada registro à parte da peça em que ele é realmente bom.

Carregar primeiro

• ${CLAUDE_PLUGIN_ROOT}/references/frameworks/voice-and-audience.md — o perfil do público e as restrições rígidas do criador.
• ${CLAUDE_PLUGIN_ROOT}/references/frameworks/technical-clarity.md — a divisão quadro/payload e a disciplina do payload. Referência central aqui.
• ${CLAUDE_PLUGIN_ROOT}/references/frameworks/writing-quality.md — o portão vivo, executado antes da entrega.
• A seção de plataforma alvo de ${CLAUDE_PLUGIN_ROOT}/references/platforms/platform-playbook.md.

Portão de atualização

Antes de usar qualquer benchmark de plataforma, alegação de algoritmo ou alegação numérica de desempenho desta habilidade ou do playbook, verifique references/research/source-ledger.md para suporte não expirado. Se o suporte estiver ausente ou tiver vencido a revisão, execute banger-research, marque a alegação como não verificada ou omita-a.

Passo 1: nomeie o mecanismo

Escreva uma frase, para você, não para o leitor: o que o leitor entende depois disso que não entendia antes? Um mecanismo por peça. Se precisar de duas frases, são duas peças.

Em seguida, nomeie o modelo errado que o leitor provavelmente tem agora. Conteúdo técnico forte substitui um modelo errado, em vez de preencher um vazio. Esse modelo errado geralmente é o gancho.

Passo 2: verifique a prova

Antes de rascunhar, nomeie:

• o artefato (repositório, arquivo, commit, captura de tela, texto de erro, benchmark),
• o que realmente aconteceu, incluindo a parte que falhou,
• o que não foi testado, declarado de forma clara.

Se não houver artefato, esta é uma peça de opinião, não um explicador. Roteie para banger-threads ou banger-longform-written e informe.

Passo 3: defina a profundidade da explicação

Use o perfil do público de voice-and-audience.md. A diretriz principal governa: combine o vocabulário com a sofisticação real do público.

• Público não especialista — defina cada primitiva na mesma frase, com uma analogia simples. Mostre a tela exata, o prompt e o resultado. O payload fica mais longo, os passos ficam menores. Nunca fale como se o leitor fosse inferior.
• Público praticante — abreviações internas são gratuitas, e explicar demais perde o tempo deles. Gaste o espaço com tradeoffs, modos de falha e o que você faria de diferente.

Passo 4: rascunhe com a divisão

Quadro (voz do autor, não as regras de clareza):

• Um gancho que nomeia o modelo errado específico ou a dor específica, não a categoria.
• A história: o que você estava fazendo, o que quebrou, quanto custou.
• O julgamento: o que você pensa agora e o quão confiante está.
• A chamada para ação nativa da plataforma.

Payload (clareza técnica):

• Um nome por conceito, mantido por toda a peça.
• Uma ideia por frase, aproximadamente 25 palavras, passos mais perto de 20.
• Voz ativa com um ator nomeado: "o parser lê o arquivo".
• Verbos, não nominalizações. Números mostrados, não qualidade alegada.
• Artefatos concretos: comandos reais, erros reais, caminhos reais.

Mantenha contrações, apartes, humor e opinião dentro do payload onde eles têm peso. Disciplina não é o mesmo que achatar.

Passo 5: formato da plataforma

• Thread no X ou Bluesky — um passo do mecanismo por post. O quadro é o post um e o último post. Os posts de payload carregam um bloco de código ou captura de tela quando possível. Nunca mais longo do que o mecanismo exige.
• LinkedIn — gancho nos primeiros 150 caracteres, enquadramento do modelo errado, depois três ou quatro batidas de payload em parágrafos curtos. Termine com o julgamento mais uma pergunta. Sem links no corpo.
• Newsletter ou Substack — um cabeçalho por passo do mecanismo, um diagrama ou bloco de código por passo, destaque o julgamento. Forneça notas independentes extraídas do payload, não do quadro.
• Descrição de vídeo ou post estilo docs — o payload domina, o quadro encolhe para duas linhas.
• Grupo no Facebook — não use este procedimento. Roteie para banger-longform-written, liderado por pergunta e curto.

Passo 6: verifique antes de entregar

Execute o portão writing-quality.md, depois estes:

1. Um leitor consegue repetir o mecanismo com o post fechado?
2. Cada conceito é chamado exatamente por um nome?
3. Algo alegou qualidade em vez de mostrá-la?
4. O quadro ainda soa como se o autor tivesse dito em voz alta?
5. Cada número, citação e resultado é rastreável a um artefato real?
6. As restrições rígidas do criador (pontuação proibida, frases, tom) estão satisfeitas?

Formato de saída

Comece com o ativo finalizado, pronto para colar, formatado para a plataforma. Depois:

• a frase do mecanismo e o modelo errado que ela substitui,
• o artefato ao qual cada alegação remonta,
• qualquer coisa rotulada como não verificada,
• a aprovação necessária em seguida.

Rascunhar é livre. Publicar, agendar e divulgar precisam da aprovação explícita do criador por item.