Guidelines for writing good analogies to make your explanations better. Use when the learner needs a concrete bridge from something already known to something new, or when the learner needs an intuitive anchor for an abstract or unfamiliar idea or when the learner has a misconception that needs a bridge from something they already understand.
Choose and deliver the right analogy-based teaching move so the learner can connect new ideas to prior knowledge, notice deep structure, or revise a misconception without mistaking the analogy for the concept itself.
references/internal_scaffolds.md provides you with scaffoldding to write analogies - these are internal templates you can use to write analogies more efficiently. Never show the user the internal scaffold directly.Use whatever form best fits the moment. Usually that means a short natural analogy, a brief limit only if it matters, and a return to the real concept or next learner action rather than a fixed format.