Agent-almanac attune
git clone https://github.com/pjt222/agent-almanac
T=$(mktemp -d) && git clone --depth=1 https://github.com/pjt222/agent-almanac "$T" && mkdir -p ~/.claude/skills && cp -r "$T/i18n/caveman-ultra/skills/attune" ~/.claude/skills/pjt222-agent-almanac-attune-32fbfb && rm -rf "$T"
i18n/caveman-ultra/skills/attune/SKILL.mdAttune
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
User-Intent check → surface OK but deeper offheal
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.
→
— deep attention for intent; attune = how, listen = whatlisten
— User-Intent Alignment check; attune goes deeper relationalheal
— sustained neutral; attune applies it to personobserve
— radiant authenticity; attune without it → mimicryshine
— micro-reset → mid-session re-attunebreathe