🗣️ Comunicación y aprendizaje
Los comandos de comunicación de la familia 10: comprimir sin perder lo esencial, explicar al nivel adecuado, enseñar de forma progresiva, traducir y reescribir preservando la intención, cambiar el formato y adaptar a la audiencia.
📰 /brief — síntesis ejecutiva en una pantalla
Entrega solo el contexto indispensable, la decisión, las evidencias, los riesgos y la próxima acción. Un brief no es un resumen: el resumen acorta todo por igual; el brief elimina lo que no cambia la decisión y conserva lo que sí la cambia.
🗜️ Los 5 bloques del brief, en este orden
- •Decisión solicitada o tomada: primera línea. Quien solo la lee ya sabe de qué se trata.
- •Contexto indispensable: 2-3 frases. Si la decisión sigue teniendo sentido sin la frase, elimínala.
- •Evidencias: los 2-3 hechos que lo sustentan — con fuente.
- •Riesgos: qué puede salir mal y qué se hace si pasa.
- •Próxima acción: quién hace qué y para cuándo.
🎯 Copia y ejecuta
/brief sobre <documento, análise ou situação>; decisão na primeira linha, contexto em até 3 frases, 3 evidências com fonte, 2 riscos com mitigação e próxima ação com dono e data; máximo de 200 palavras
Cómo verificar: cabe en la pantalla de un celular sin desplazarte, y la primera línea por sí sola ya dice qué está en juego.
✓ Brief que decide
- ✓"Recomiendo migrar al gateway B en octubre. El costo baja un 18% (propuesta adjunta); riesgo: 1 semana de integración — Ana lidera, plan B: mantener A hasta diciembre."
- ✓Quien lee en 40 segundos puede decir sí, no o «necesito saber X».
✗ Resumen informativo
- ✗"Este documento analiza las opciones de gateway de pago considerando diversos factores relevantes para el contexto actual de la empresa..."
- ✗Tres párrafos después, la recomendación aún no aparece.
💬 /explain — explica al nivel adecuado
Adapta profundidad y vocabulario al nivel del público y usa ejemplos cuando mejoran la comprensión. El parámetro que hace funcionar el comando es el nivel; sin él, el modelo supone un público promedio que no existe.
| Nivel | Qué cambia | Ejemplo para «API» |
|---|---|---|
| Persona sin conocimientos técnicos | Analogía cotidiana, cero jerga | "Es el mesero entre tú y la cocina: tú pides, él trae." |
| Principiante técnico | Concepto + un ejemplo concreto | "Una dirección que acepta solicitudes en un formato definido y devuelve datos." |
| Profesional | Precisión, trade-offs, sin analogías | "Contrato REST o gRPC, versionado, con autenticación y límites de tasa." |
El mismo concepto, tres explicaciones correctas: la diferencia está en para quién son.
🎯 Copia y ejecuta
/explain <conceito> para <nível: leigo | iniciante técnico | profissional | especialista>; ajuste vocabulário e profundidade, use no máximo um exemplo e diga o que deixou de fora por causa do nível
Cómo verificar: la última parte ("dejé fuera X") existe: es lo que evita que una explicación sencilla se convierta en una explicación equivocada.
💡 Consejo práctico
Pide "explica para
🎓 /teach — enseña progresivamente
Organiza concepto, intuición, ejemplo, práctica, error común y verificación del aprendizaje. Seis etapas en orden fijo — porque saltarse la intuición produce memorización y saltarse la verificación produce una falsa confianza.
Concepto e intuición
Nombre + definición en una frase, luego la imagen mental: «piensa en esto como...». La intuición va antes que el rigor.
Ejemplo y práctica
Un ejemplo resuelto y después un problema parecido para que la persona lo haga. Sin práctica, el ejemplo es entretenimiento.
Error común y verificación
El error que todo principiante cometió, nombrado; luego, una pregunta que solo responde bien quien entendió.
¿Nuevo por aquí? Verificación del aprendizaje es una pregunta o tarea breve que distingue a quien entendió de quien memorizó. "¿Qué es X?" evalúa la memoria; "¿qué pasaría con X si Y cambiara?" evalúa la comprensión. La segunda es la que importa.
🎯 Copia y ejecuta
/teach <conceito> para <perfil do aprendiz>; conceito em uma frase, intuição com imagem mental, exemplo resolvido, exercício para praticar, o erro mais comum e uma pergunta de verificação que exige compreensão (não memória)
Cómo verificar: la pregunta final no se puede responder copiando la definición: si se puede, es memoria, no verificación.
🔤 /translate + /rewrite — intención preservada
/translate mantiene significado, tono y términos técnicos, adaptando solo lo necesario. /rewrite conserva lo esencial y optimiza para un objetivo declarado: claridad, tono, persuasión o concisión. Ninguno de los dos inventa contenido: ambos protegen la intención.
✓ Reescritura con objetivo
- ✓"/rewrite objetivo=concisão: reduce 40% while keeping all the numbers and the call to action."
- ✓"/translate a en-US manteniendo los términos técnicos que ya se usan en inglés y el tono informal."
✗ Reescritura a la deriva
- ✗"Mejora este texto" — ¿para qué? El modelo elige un objetivo al azar y tú no sabes cuál.
- ✗Traducción que «adapta» el chiste, el ejemplo y el orden de los argumentos, y devuelve otro texto.
🎯 Copia y ejecuta
/rewrite <texto> com objetivo=<clareza | tom X | persuasão | concisão N%>; preserve todos os fatos, números e a CTA; liste ao final o que mudou e por quê
Cómo verificar: la lista de cambios no contiene ningún hecho nuevo ni ningún hecho eliminado: solo cambios de forma.
💡 Consejo práctico
Para traducir material técnico, proporciona un glosario: "mantén en inglés: deploy, endpoint, webhook". Así evitas que "deploy" se convierta en "implementación" a mitad de un tutorial que usa el término en inglés.
🧾 /format — transforma el formato, no el contenido
Convierte la la misma información para tabla, JSON, checklist, memo, guion u otro formato. La regla de oro: nada entra, nada sale — solo cambia la forma. Si el nuevo formato "necesitó" un dato más, se usó el comando equivocado.
| Uso | Formato | ¿Por qué? |
|---|---|---|
| Comparar opciones | Tabla | La mirada recorre las columnas; las diferencias saltan a la vista |
| Ejecutar sin olvidar | Lista de verificación | Cada línea es binaria y se puede tachar |
| Alimentar el sistema o al agente | JSON | La máquina lo lee sin interpretar |
| Convencer a alguien ocupado | Memo de una página | Decisión arriba, argumento abajo |
| Grabar un video o presentar | Guion con tiempos | El habla tiene ritmo; el texto corrido, no |
Elige el formato según lo que la persona va a HACER con la información, no según lo que se ve bonito.
🎯 Copia y ejecuta
/format <conteúdo> para <tabela | checklist | JSON com schema X | memo | roteiro>; não adicione nem remova informação; ao final, confirme que todos os itens do original estão presentes
Cómo verificar: la confirmación final enumera los elementos del original y marca cada uno como presente: ninguno está "adaptado" ni "resumido".
¿Nuevo por aquí? Schema es la definición de la estructura de un JSON: qué campos existen, de qué tipo son y cuáles son obligatorios. Pedir "/format para JSON" sin schema devuelve una estructura inventada; con schema, devuelve exactamente la que espera tu sistema.
👥 /audience — adapta a la audiencia
Ajusta lenguaje, ejemplos, profundidad, objeciones y llamado a la acción para el público definido. Es /explain con dos ingredientes más: las objeciones que planteará esa audiencia y lo que quieres que haga después de leer.
🎯 Qué cambia según la audiencia
- •Ejemplos: el área financiera entiende «R$ 40 mil/año»; el área técnica entiende «3 sprints»; el cliente entiende «una tarde menos por semana».
- •Objeciones: cada público tiene la suya: costo, riesgo técnico, tiempo de adaptación. Anticipa la correcta.
- •CTA: "aprueba el presupuesto", "revisa la arquitectura", "prueba gratis por 14 días" — tres públicos, tres verbos.
🎯 Copia y ejecuta
/audience <mensagem> para <público: cargo, nível técnico, o que ele ganha e o que ele teme>; ajuste exemplos e profundidade, antecipe as 2 objeções mais prováveis desse público e termine com a chamada à ação certa para ele
Cómo verificar: las objeciones anticipadas son las que ESTE público plantearía, no objeciones genéricas. Y la CTA es un verbo que ese público puede ejecutar.
⚠️ Adaptar no es adular
Adaptar el mensaje a la audiencia cambia los ejemplos, el orden y el énfasis; no cambia los hechos, los riesgos ni la recomendación. Si la versión para el director oculta el riesgo que muestra la versión para el equipo, eso no es /audience, es una omisión.
🔗 Pipeline /brief → /explain → /audience
Los comandos de comunicación ganan fuerza cuando se encadenan. El orden comprimir → calibrar → adaptar no es arbitraria: cada etapa trabaja sobre el resultado de la anterior, e invertir cualquier par desperdicia trabajo.
Ilustrativo: tres preguntas en secuencia: qué es indispensable, qué profundidad, para quién.
🎯 Copia y ejecuta
/chain(/brief -> /explain nível=<nível> -> /audience público=<público>) sobre <documento>; mostre a saída de cada etapa separadamente antes da versão final
Cómo verificar: la salida de /brief ya está incluida en la salida de /explain, que está incluida en la respuesta final: nada se volvió a agregar después de recortarlo.
💡 Receta compuesta
Ejecuta la cadena una vez por público: /chain(/brief -> /audience público=diretoria), después ... público=time técnico. El /brief es el mismo; solo cambia la última etapa. Así es como un análisis se convierte en tres mensajes sin convertirse en tres análisis.
¿Nuevo por aquí? Traspaso de salida es el mecanismo de /chain (detallado en el módulo 6.2): el resultado de un comando entra como insumo del siguiente, sin que tengas que copiar y pegar. Es lo que garantiza que /audience trabaje sobre el brief y no otra vez sobre el documento original.
🛠️ Taller: un email en 4 formatos
Hora de ejecutar todo junto. Toma un correo electrónico real — preferiblemente uno que hayas tenido que enviar a más de una persona y que hayas enviado igual a todas. Se convertirá en cuatro piezas, con el mismo contenido y distintos lectores.
Versión 1 — quién aprueba
/brief /audience público=diretoria. Decisión en la primera línea, costo y riesgo, CTA «aprobar antes del viernes».
Versión 2 — quién ejecuta
/explain nível=profissional /audience público=time técnico. Trade-offs explícitos, objeción anticipada: «¿va a retrasar la entrega X?»
Versión 3 — quién opera
/format checklist. Cada paso binario, el orden de ejecución y qué verificar.
Versión 4 — socio externo
/translate en-US /rewrite objetivo=tom formal. Términos técnicos preservados, información interna eliminada — y declarada como eliminada.
🎯 Copia y ejecuta
/chain(/brief -> /audience público=diretoria) sobre <cole o e-mail>; depois /explain nível=profissional /audience público=time técnico; depois /format checklist; depois /translate en-US /rewrite objetivo=formal. Ao final, tabela: cada fato do original × presente em qual versão
Cómo verificar: la tabla final muestra que todos los hechos del original están presentes en las versiones 1-3; en la versión 4, cada ausencia se declara y justifica ("información interna").
✓ Taller bien hecho
- ✓Cuatro textos de tamaños muy diferentes con el mismo conjunto de hechos.
- ✓Puedes señalar, en cada versión, qué comando produjo cada cambio.
✗ Taller que se convirtió en reescritura
- ✗Cuatro textos parecidos con sinónimos intercambiados.
- ✗La versión para la dirección tiene 3 párrafos de contexto: el /brief no se ejecutó, solo se mencionó.
Autoverificación rápida (opcional): ¿qué diferencia hay entre /brief y un resumen común?
🎓 Resumen del módulo
Próximo Módulo:
6.2 - Meta comandos y maestría — /mode, /chain y /preset: los tres comandos que operan sobre los otros 97 y cierran el curso.