Banger Explainer — contenido didáctico que sobrevive al compartirse
El contenido didáctico falla en dos direcciones. Demasiada voz y el lector lo disfruta pero no puede repetirlo. Demasiada especificación y parece documentación que nadie comparte. Este procedimiento asigna cada registro a la parte de la pieza en la que realmente funciona.
Cargar primero
${CLAUDE_PLUGIN_ROOT}/references/frameworks/voice-and-audience.md— el perfil de la audiencia y las restricciones duras del creador.${CLAUDE_PLUGIN_ROOT}/references/frameworks/technical-clarity.md— la división marco/carga útil y la disciplina de la carga útil. Referencia central aquí.${CLAUDE_PLUGIN_ROOT}/references/frameworks/writing-quality.md— el filtro vivo, ejecutar antes de entregar.- La sección de la plataforma objetivo de
${CLAUDE_PLUGIN_ROOT}/references/platforms/platform-playbook.md.
Filtro de actualidad
Antes de usar cualquier referencia de plataforma, afirmación algorítmica o afirmación numérica de rendimiento de esta habilidad o del manual, consulta references/research/source-ledger.md para ver si hay soporte no caducado. Si el soporte falta o está desactualizado, ejecuta banger-research, etiqueta la afirmación como no verificada, u omítela.
Paso 1: nombrar el mecanismo
Escribe una frase, para ti, no para el lector: ¿qué entiende el lector después de esto que no entendía antes? Un mecanismo por pieza. Si necesitas dos frases, son dos piezas.
Luego nombra el modelo erróneo que probablemente tiene el lector ahora. El contenido técnico sólido reemplaza un modelo erróneo, no llena uno vacío. Ese modelo erróneo suele ser el gancho.
Paso 2: verificar la prueba
Antes de redactar, nombra:
- el artefacto (repositorio, archivo, commit, captura de pantalla, texto de error, punto de referencia),
- lo que realmente sucedió, incluida la parte que falló,
- lo que no se ha probado, expresado claramente.
Si no hay artefacto, esto es una pieza de opinión, no un explicador. Dirígelo a banger-threads o banger-longform-written y dímelo.
Paso 3: fijar la profundidad de la explicación
Usa el perfil de la audiencia de voice-and-audience.md. Rige la directiva principal: adapta el vocabulario a la sofisticación real de la audiencia.
- Audiencia no experta — define cada primitivo al mismo tiempo, con una analogía simple. Muestra la pantalla exacta, el prompt y el resultado. La carga útil se alarga, los pasos se acortan. Nunca hables con condescendencia.
- Audiencia profesional — las abreviaturas internas son gratuitas, y explicar en exceso les hace perder tiempo. Dedica el espacio a compensaciones, modos de fallo y lo que harías diferente.
Paso 4: redactar con la división
Marco (voz del autor, no las reglas de claridad):
- Un gancho que nombre el modelo erróneo específico o el dolor específico, no la categoría.
- La historia: qué estabas haciendo, qué se rompió, qué costó.
- El juicio: lo que piensas ahora y con cuánta confianza.
- La llamada a la acción nativa de la plataforma.
Carga útil (claridad técnica):
- Un nombre por concepto, mantenido durante toda la pieza.
- Una idea por frase, aproximadamente 25 palabras, los pasos cerca de 20.
- Voz activa con un actor nombrado: "el analizador lee el archivo".
- Verbos, no nominalizaciones. Números mostrados, no calidad afirmada.
- Artefactos concretos: comandos reales, errores reales, rutas reales.
Mantén contracciones, incisos, humor y opinión dentro de la carga útil cuando tengan peso. La disciplina no es lo mismo que aplanar.
Paso 5: forma según la plataforma
- Hilo de X o Bluesky — un paso del mecanismo por publicación. El marco es la primera y la última publicación. Las publicaciones de carga útil llevan un bloque de código o una captura de pantalla cuando sea posible. Nunca más largo de lo que requiere el mecanismo.
- LinkedIn — gancho en los primeros 150 caracteres, marco del modelo erróneo, luego tres o cuatro golpes de carga útil en párrafos cortos. Termina con el juicio más una pregunta. Sin enlaces en el cuerpo.
- Newsletter o Substack — un encabezado por paso del mecanismo, un diagrama o bloque de código por paso, cita destacada del juicio. Proporciona Notas independientes extraídas de la carga útil, no del marco.
- Descripción de video o publicación tipo documentación — la carga útil domina, el marco se reduce a dos líneas.
- Grupo de Facebook — no uses este procedimiento. Dirígelo a
banger-longform-written, guiado por preguntas y breve.
Paso 6: verificar antes de entregar
Ejecuta el filtro de writing-quality.md, luego esto:
- ¿Podría un lector repetir el mecanismo con la publicación cerrada?
- ¿Se llama exactamente con un nombre a cada concepto?
- ¿Algo afirmó calidad en lugar de mostrarla?
- ¿Sigue sonando el marco como si el autor lo hubiera dicho en voz alta?
- ¿Cada número, cita y resultado se puede rastrear hasta un artefacto real?
- ¿Se cumplen las restricciones duras del creador (puntuación prohibida, frases, tono)?
Formato de salida
Comienza con el activo terminado, listo para pegar, formateado para la plataforma. Luego:
- la frase del mecanismo y el modelo erróneo que reemplaza,
- el artefacto al que se remonta cada afirmación,
- cualquier cosa etiquetada como no verificada,
- la aprobación necesaria a continuación.
Redactar es gratuito. Publicar, programar y hacer divulgación necesitan la aprobación explícita del creador para cada elemento.