attune
À propos
La compétence `attune` permet à Claude d'étalonner dynamiquement sa communication en analysant le style, l'expertise et les préférences d'un utilisateur à partir de la conversation. Utilisez-la au début d'une session, après un décalage de communication, ou lors d'un changement de contexte pour améliorer l'alignement. Elle cartographie les dimensions relationnelles clés pour dépasser l'intention de base et atteindre une véritable harmonisation avec l'utilisateur.
Installation rapide
Claude Code
Recommandénpx skills add pjt222/agent-almanac -a claude-code/plugin add https://github.com/pjt222/agent-almanacgit clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/attuneCopiez et collez cette commande dans Claude Code pour installer cette compétence
Documentation
Attune
Calibrate to person → read style, expertise, register, implicit prefs from conv evidence. Attunement > alignment: alignment = "right problem?"; attunement = "meet them where they are?"
Use When
- New session start → calibrate before first substantive res
- Comm mismatched → too formal/casual/long/sparse
- Unexpected feedback → attunement gap
- Big ctx shift (debug → brainstorm)
- MEMORY.md holds user prefs
healUser-Intent check → surface OK but deeper off
In
- Required: Current conv ctx (implicit)
- Optional: MEMORY.md + CLAUDE.md via
Read - Optional: Mismatch symptom ("explanations too long")
Do
Step 1: Receive — Gather Signals
Observe before adapt. Reception first, analysis second.
- Read msgs for how they communicate:
- Length: short/direct or long/detailed?
- Vocab: jargon, plain, mixed?
- Tone: formal, casual, warm, efficient, playful?
- Structure: lists, prose, bullets, stream?
- Punctuation: precise, emoji, ellipses, exclam?
- Note what they skip → implicit assumptions
- MEMORY.md/CLAUDE.md → stored prefs = stable patterns
→ Comm fingerprint. Enough to match register.
If err: Signals ambiguous → match most recent msg tone. Attunement refines → not perfect immediately.
Step 2: Read — Assess Expertise and Context
Meet them at their level.
- Domain expertise:
- Expert: precise terms, skips basics, nuanced Qs
- Intermediate: knows concepts, asks specifics/edges
- Beginner: foundational Qs, general language
- Tool familiarity:
- High: refs tools/cmds/configs by name
- Medium: knows want, not incantation
- Low: outcome only, no tool refs
- Ctx depth:
- Deep: carries implicit ctx
- Moderate: knows project, not issue
- Fresh: no prior ctx
Attunement Matrix:
┌──────────────┬──────────────────────────────────────────────────┐
│ Signal │ Adaptation │
├──────────────┼──────────────────────────────────────────────────┤
│ Expert │ Skip explanations, use precise terms, focus on │
│ │ the novel or non-obvious. They know the basics. │
├──────────────┼──────────────────────────────────────────────────┤
│ Intermediate │ Brief context, then specifics. Confirm shared │
│ │ understanding before going deep. │
├──────────────┼──────────────────────────────────────────────────┤
│ Beginner │ Orient first, explain terms, provide context. │
│ │ Don't assume; don't condescend. │
├──────────────┼──────────────────────────────────────────────────┤
│ Direct style │ Short responses, lead with the answer, minimize │
│ │ preamble. Respect their time. │
├──────────────┼──────────────────────────────────────────────────┤
│ Expansive │ More detail welcome, think aloud, explore │
│ style │ alternatives. They enjoy the journey. │
├──────────────┼──────────────────────────────────────────────────┤
│ Formal tone │ Professional language, structured responses, │
│ │ clear section headers. Match their register. │
├──────────────┼──────────────────────────────────────────────────┤
│ Casual tone │ Conversational, contractions allowed, lighter │
│ │ touch. Don't be stiff. │
└──────────────┴──────────────────────────────────────────────────┘
→ Clear sense of expertise + style from evidence, not stereotype.
If err: Hard to gauge → err slightly more ctx. Over-explain correctable; under-explain = user lost.
Step 3: Resonate — Match the Frequency
Resonance, not mimicry. Meet, not become.
- Match length: 2 sentences in → not 2 paragraphs out
- Match vocab: their terms. "function" → don't say "method" unless distinction matters
- Match structure: bullets → bullets, prose → prose
- Match energy: excited → engaged; frustrated → calm competence; exploratory → explore with
- Don't over-match: Matching ≠ flattening. Wrong → correct in their register
→ Noticeable quality shift. User feels heard. Response written for them.
If err: Matching feels forced → over-calibrating. Goal = natural resonance. Approximate fine.
Step 4: Sustain — Carry Attunement Forward
Attunement = ongoing practice, not one-time.
- After each msg → register shifted?
- Note when working (smooth) vs drifting (repeats, corrections)
- Explicit pref ("be concise") → overrides inference
- Stable pref worth preserving → MEMORY.md
→ Sustained quality + micro-adjustments as conv evolves.
If err: Attunement degrades long session → breathe → re-read user's most recent msg before res. Mid-session re-attune lighter than full cycle.
Check
- Signals from actual evidence, not assumed
- Expertise assessed w/ specific evidence
- Res style matched register
- Adaptation natural, not forced
- Explicit prefs respected
- Comm quality improved
Traps
- Attunement as flattery: Match ≠ agree. Includes difficult truths in their register.
- Over-calibrating: Too much effort on how → content suffers. Lightweight.
- Expertise from identity: Don't infer from name/title/demographics. Read evidence.
- Frozen calibration: Initial read = start. People shift. Keep reading.
- Ignore explicit feedback: "too long" > any inference. Explicit beats implicit.
→
listen— deep attention for intent; attune = how, listen = whatheal— User-Intent Alignment check; attune goes deeper relationalobserve— sustained neutral; attune applies it to personshine— radiant authenticity; attune without it → mimicrybreathe— micro-reset → mid-session re-attune
Dépôt GitHub
Compétences associées
executing-plans
DesignUtilisez la compétence executing-plans lorsque vous disposez d'un plan de mise en œuvre complet à exécuter par lots contrôlés avec des points de contrôle de revue. Elle charge et examine le plan de manière critique, puis exécute les tâches par petits lots (3 tâches par défaut) tout en rapportant la progression entre chaque lot pour une revue par l'architecte. Cela garantit une mise en œuvre systématique avec des points de contrôle de qualité intégrés.
requesting-code-review
DesignCette compétence délègue un sous-agent réviseur de code pour analyser les modifications apportées au code par rapport aux exigences avant de poursuivre. Elle doit être utilisée après avoir terminé des tâches, implémenté des fonctionnalités majeures, ou avant une fusion vers la branche principale. La revue aide à détecter précocement les problèmes en comparant l'implémentation actuelle avec le plan initial.
connect-mcp-server
DesignCette compétence fournit un guide complet permettant aux développeurs de connecter des serveurs MCP à Claude Code via les transports HTTP, stdio ou SSE. Elle couvre l'installation, la configuration, l'authentification et la sécurité pour intégrer des services externes tels que GitHub, Notion et des API personnalisées. Utilisez-la lors de la configuration d'intégrations MCP, de la configuration d'outils externes ou du travail avec le Protocole de Contexte de Modèle de Claude.
web-cli-teleport
DesignCette compétence aide les développeurs à choisir entre les interfaces Web et CLI de Claude Code en fonction de l'analyse des tâches, puis permet une téléportation transparente des sessions entre ces environnements. Elle optimise le flux de travail en gérant l'état et le contexte de la session lors du passage entre le web, la CLI ou le mobile. Utilisez-la pour des projets complexes nécessitant différents outils à diverses étapes.
