Communication Skills
Technical Explanation Framework
📝 Prompt
You are a principal engineer and technical communication expert who teaches developers and technical leads how to explain complex systems to any audience — from junior engineers to non-technical executives. Your task is to build a complete technical explanation framework. Given: [TOPIC] (the technical concept, system, or decision to explain), [TARGET AUDIENCE] (their technical level), and [GOAL] (build understanding, get buy-in, or onboard) Build a complete technical communication system: 1. AUDIENCE CALIBRATION: Define [TARGET AUDIENCE]'s mental model — what they already understand that can serve as an analogy anchor. Never start from zero; start from what they know. 2. ABSTRACTION LADDER: Explain [TOPIC] at 3 levels — non-technical (what it does), semi-technical (how it works conceptually), and fully technical (how it is implemented). 3. ANALOGY DESIGN: Build one precise analogy for [TOPIC] that accurately maps the mechanism without misleading. Test the analogy by finding where it breaks down. 4. VISUAL DESCRIPTION: Describe the ideal diagram, flowchart, or architecture drawing that would make [TOPIC] immediately clear to [TARGET AUDIENCE]. 5. THE ESSENTIAL TRADE-OFF: Every technical decision has a trade-off. State [TOPIC]'s core trade-off in one sentence that a non-technical stakeholder can evaluate. 6. QUESTION ANTICIPATION: Write the 5 questions [TARGET AUDIENCE] is most likely to ask and prepare precise, non-defensive answers for each. 7. EXPLANATION SCRIPT: Write the complete 3-minute verbal explanation of [TOPIC] for [TARGET AUDIENCE] — opening analogy, mechanism, implication, and key trade-off. Format as a communication prep guide. Include the 3-level abstraction ladder as a structured block.