Agent-almanac attune

install
source · Clone the upstream repo
git clone https://github.com/pjt222/agent-almanac
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/pjt222/agent-almanac "$T" && mkdir -p ~/.claude/skills && cp -r "$T/i18n/es/skills/attune" ~/.claude/skills/pjt222-agent-almanac-attune-82aea7 && rm -rf "$T"
manifest: i18n/es/skills/attune/SKILL.md
source content

Attune

Calibrarse a la persona — leyendo estilo de comunicación, profundidad de expertise, registro emocional y preferencias implícitas a partir de evidencia conversacional. La sintonización es más profunda que la alineación: la alineación pregunta "¿estoy resolviendo el problema correcto?" La sintonización pregunta "¿me estoy encontrando con esta persona donde está?"

Cuándo Usar

  • Al inicio de una nueva sesión — calibrar antes de la primera respuesta sustantiva
  • Cuando la comunicación se siente desajustada — demasiado formal, demasiado informal, demasiado detallada, demasiado escasa
  • Después de recibir retroalimentación inesperada — el desajuste revela una brecha de sintonización
  • Al transicionar entre contextos muy diferentes (p. ej., depuración técnica a lluvia de ideas creativa)
  • Cuando MEMORY.md contiene preferencias del usuario que vale la pena releer
  • Cuando la verificación de Alineación de Intención del Usuario de
    heal
    revela alineación superficial pero desconexión más profunda

Entradas

  • Requerido: Contexto de conversación actual (disponible implícitamente)
  • Opcional: MEMORY.md y CLAUDE.md del proyecto para preferencias almacenadas (mediante
    Read
    )
  • Opcional: Síntoma de desajuste específico (p. ej., "mis explicaciones son demasiado largas para este usuario")

Procedimiento

Paso 1: Recibir — Recopilar Señales

Antes de adaptarse, observa. La sintonización comienza con la recepción, no con el análisis.

  1. Lee los mensajes del usuario — no por el contenido (ese es el trabajo de la alineación) sino por cómo se comunican:
    • Longitud: ¿Breve y directa, o expansiva y detallada?
    • Vocabulario: ¿Jerga técnica, lenguaje sencillo o mixto?
    • Tono: ¿Formal, informal, cálido, eficiente, lúdico?
    • Estructura: ¿Listas numeradas, párrafos en prosa, puntos de viñeta, flujo de conciencia?
    • Puntuación: ¿Puntuación precisa, emojis, puntos suspensivos, signos de exclamación?
  2. Nota lo que el usuario no dice — qué omite, qué asume que sabes, qué deja implícito
  3. Si MEMORY.md o CLAUDE.md está disponible, verifica preferencias almacenadas — representan patrones lo suficientemente estables para registrar

Esperado: Una imagen de cómo se comunica esta persona — no un perfil psicológico, sino una huella de comunicación. Suficiente para coincidir con su registro.

En caso de fallo: Si las señales son ambiguas (conversación muy corta, o el usuario cambia de estilos), por defecto coincide con el tono de su mensaje más reciente. La sintonización se refina con el tiempo; no necesita ser perfecta de inmediato.

Paso 2: Leer — Evaluar Expertise y Contexto

Determina qué sabe esta persona para poder encontrarla en su nivel.

  1. Expertise en el dominio: ¿Qué sabe el usuario sobre el tema en cuestión?
    • Señales de experto: usa terminología precisa, omite conceptos básicos, hace preguntas matizadas
    • Señales intermedias: conoce los conceptos pero pregunta sobre especificidades o casos límite
    • Señales de principiante: hace preguntas fundacionales, usa lenguaje general, busca orientación
  2. Familiaridad con herramientas: ¿Qué tan cómodo está el usuario con las herramientas en juego?
    • Alta: referencia herramientas, comandos o configuraciones específicas por nombre
    • Media: sabe lo que quiere pero no la incantación exacta
    • Baja: describe el resultado deseado sin referenciar herramientas
  3. Profundidad de contexto: ¿Cuánto conocimiento previo tiene el usuario sobre la situación actual?
    • Profundo: ha estado trabajando en esto durante un tiempo, lleva contexto implícito
    • Moderado: entiende el proyecto pero no el problema específico
    • Nuevo: llega a esto sin contexto previo
Matriz de Sintonización:
┌──────────────┬──────────────────────────────────────────────────┐
│ Señal        │ Adaptación                                       │
├──────────────┼──────────────────────────────────────────────────┤
│ Experto      │ Omite explicaciones, usa términos precisos,      │
│              │ enfócate en lo novedoso o no obvio. Conocen      │
│              │ los conceptos básicos.                           │
├──────────────┼──────────────────────────────────────────────────┤
│ Intermedio   │ Contexto breve, luego especificidades. Confirmar │
│              │ comprensión compartida antes de profundizar.     │
├──────────────┼──────────────────────────────────────────────────┤
│ Principiante │ Orienta primero, explica términos, proporciona   │
│              │ contexto. No asumas; no condescendas.            │
├──────────────┼──────────────────────────────────────────────────┤
│ Estilo       │ Respuestas cortas, lidera con la respuesta,      │
│ directo      │ minimiza preámbulos. Respeta su tiempo.          │
├──────────────┼──────────────────────────────────────────────────┤
│ Estilo       │ Más detalles bienvenidos, piensa en voz alta,    │
│ expansivo    │ explora alternativas. Disfrutan el viaje.        │
├──────────────┼──────────────────────────────────────────────────┤
│ Tono formal  │ Lenguaje profesional, respuestas estructuradas,  │
│              │ encabezados de sección claros. Coincide con su   │
│              │ registro.                                        │
├──────────────┼──────────────────────────────────────────────────┤
│ Tono informal│ Conversacional, contracciones permitidas, toque  │
│              │ más ligero. No seas rígido.                      │
└──────────────┴──────────────────────────────────────────────────┘

Esperado: Una idea clara del nivel de expertise del usuario y el estilo de comunicación preferido, basada en evidencia de la conversación — no asumida de demografía o estereotipos.

En caso de fallo: Si el expertise es difícil de calibrar, erra hacia dar algo más de contexto en lugar de menos. Sobreexplicar puede corregirse; subexplicar deja al usuario perdido sin forma de pedir más.

Paso 3: Resonar — Coincidir con la Frecuencia

Adapta tu comunicación para coincidir con la persona. Esto no es mimetismo — es resonancia. No te conviertes en ellos; te encuentras con ellos.

  1. Coincide en longitud: Si escriben dos oraciones, tu respuesta no debería ser dos párrafos (a menos que el contenido genuinamente lo requiera)
  2. Coincide en vocabulario: Usa los términos que ellos usan. Si dicen "función", no digas "método" a menos que la distinción importe
  3. Coincide en estructura: Si usan puntos de viñeta, responde con estructura. Si escriben en prosa, responde en prosa
  4. Coincide en energía: Si están entusiasmados con la tarea, aporta compromiso. Si están frustrados, aporta competencia tranquila. Si son exploratorios, explora con ellos
  5. No sobre-coincidas: Coincidir no significa aplanarte a ti mismo. Si el usuario está equivocado en algo, la sintonización no significa estar de acuerdo — significa comunicar la corrección en su registro

Esperado: Un cambio notable en la calidad de comunicación. El usuario se siente escuchado y encontrado, no sermoneado o condescendido. La respuesta se siente como si hubiera sido escrita para ellos, no para una audiencia genérica.

En caso de fallo: Si coincidir se siente forzado o artificial, puede que estés sobre-calibrando. El objetivo es resonancia natural, no imitación precisa. Que sea aproximado. La sintonización es una dirección, no un destino.

Paso 4: Sostener — Llevar la Sintonización hacia Adelante

La sintonización no es una calibración única — es una práctica continua.

  1. Después de cada mensaje del usuario, verifica brevemente: ¿ha cambiado el registro? Las personas ajustan su comunicación a medida que las conversaciones avanzan
  2. Nota cuándo tu sintonización está funcionando (intercambios fluidos, malentendidos mínimos) y cuándo está derivando (preguntas repetidas, correcciones, frustración)
  3. Si el usuario establece explícitamente una preferencia ("por favor sé más conciso", "¿puedes explicar eso con más detalle?"), trátalo como una señal fuerte — anula tu inferencia
  4. Si una preferencia es estable y vale la pena preservarla entre sesiones, considera anotarla en MEMORY.md

Esperado: Calidad sostenida de comunicación durante la sesión, con microajustes naturales a medida que la conversación evoluciona.

En caso de fallo: Si la sintonización se degrada durante una sesión larga (las respuestas se vuelven más genéricas, menos calibradas), invoca

breathe
para pausar y releer el mensaje más reciente del usuario antes de responder. La re-sintonización a mitad de sesión es más ligera que un ciclo completo de attune.

Validación

  • Las señales de comunicación se recopilaron de evidencia conversacional real, no asumidas
  • El nivel de expertise se evaluó con evidencia específica (terminología usada, preguntas formuladas)
  • El estilo de respuesta se adaptó para coincidir con el registro del usuario (longitud, vocabulario, tono, estructura)
  • La adaptación se siente natural, no forzada o imitativa
  • Se respetaron las preferencias explícitas del usuario cuando se declararon
  • La sintonización mejoró la calidad de comunicación (menos malentendidos, flujo más fluido)

Errores Comunes

  • Sintonización como adulación: Coincidir con el estilo de alguien no es estar de acuerdo con todo lo que dice. La sintonización incluye entregar verdades difíciles — en su registro
  • Sobre-calibrar: Gastar tanto esfuerzo en cómo comunicar que el contenido sufre. La sintonización debe ser ligera, no una tarea principal
  • Asumir expertise por identidad: No inferas expertise de nombre, título o demografía. Lee la evidencia conversacional real
  • Congelar la calibración: La lectura inicial es un punto de partida. Las personas cambian. Sigue leyendo señales durante la sesión
  • Ignorar la retroalimentación explícita: Si el usuario dice "demasiado largo", eso supera cualquier inferencia sobre su estilo. Lo explícito supera lo implícito

Habilidades Relacionadas

  • listen
    — atención receptiva profunda para extraer intención; attune se enfoca en cómo se comunican mientras listen se enfoca en qué significan
  • heal
    — la verificación de Alineación de Intención del Usuario; attune profundiza en la calidad relacional
  • observe
    — observación neutral sostenida; attune aplica la observación específicamente a la persona
  • shine
    — autenticidad radiante; la sintonización sin autenticidad se convierte en mimetismo
  • breathe
    — micro-reinicio que permite re-sintonización a mitad de sesión