Tell Claude the Reader's Level So It Explains at the Right Altitude

A calibration step: tell Claude exactly who will read the explanation and what they already know, so it pitches the depth, jargon, and examples at the right altitude — the same concept explained differently for an executive, a practitioner, and an implementer.

Without an audience, Claude aims at a vague middle: too technical for the newcomer, too shallow for the expert, useful to neither. Explanation quality is mostly a function of matching the reader's existing model — the right analogy, the right amount of jargon, the right starting point. Naming the reader lets the model choose all of those deliberately instead of averaging.

Any explanation with a specific audience — onboarding docs, a concept explainer for stakeholders, a deep-dive for engineers, or the same topic you need to pitch three different ways.

A note to yourself, or when you genuinely want the full-depth version and will filter it down. Skip the calibration when you are the audience and you know your own level.

Explain <concept> for this reader: <who they are, what they already know, what they'll do with it>. Match the depth and vocabulary to them — assume what they know, define what they don't, and use an analogy that fits their world. If a term is above their level, either define it in-line or avoid it.

Asked to explain caching, Claude gives a product manager 'a copy kept close by so we don't re-fetch — faster pages, staler data if we're not careful', and gives an engineer the eviction-policy and invalidation trade-offs. Same concept, two altitudes, both land.

For docs read by mixed audiences, ask Claude to layer it: a plain-language summary anyone can read, then a 'for implementers' section with the depth. Readers self-select their altitude instead of you guessing one.

• Leaving the audience unstated and getting a mushy mid-level explanation.
• Asking for 'simple' when you mean 'for an expert who's new to this specific thing' — those differ.
• Using an analogy from a world the reader doesn't live in, which confuses more than it clarifies.