m14-mental-model_skill

Overview

This skill provides concise mental models and analogies to help learners think correctly about Rust concepts like ownership, borrowing, lifetimes, and smart pointers. It focuses on the right intuitions, common misconceptions, and visual metaphors that make compiler errors meaningful rather than mysterious. Use it to translate compiler messages and Rust rules into everyday analogies and practical troubleshooting prompts.

How this skill works

The skill inspects the concept or compiler error you’re struggling with and returns a targeted mental model (analogy), the typical wrong way to think about it, and the correct intuition to adopt. It highlights the safety guarantee being enforced and suggests the next conceptual or implementation step to explore. Visual layouts and short trace-up/trace-down prompts guide you from “why” to “how”.

When to use it

• Learning Rust fundamentals (ownership, borrowing, lifetimes)
• Interpreting borrow-checker or ownership-related compiler errors
• Transitioning from managed languages (Java, Python) to Rust
• Deciding which smart pointer (Box, Rc, Arc) fits a design
• Preparing to design safe concurrency or low-level data structures

Best practices

• Always ask: who owns the data, how long does it live, who can access it?
• Map compiler errors to the safety guarantee being violated before fixing code
• Prefer reshaping ownership (move, borrow, clone) over adding clone or unsafe as first fixes
• Use simple analogies (key, lending, ticket) to explain code reviews or teach others
• Trace up from an error to the design question, then trace down to implementation patterns

Example use cases

• Explain why a value is 'moved' and how to pass ownership safely
• Understand E0382/E0507 by mapping them to the unique-key model
• Choose between Box, Rc, and Arc using heap/remote-control analogies
• Resolve mutable vs immutable borrow errors by visualizing exclusive writer vs shared readers
• Coach a team member coming from Java/Python on Rust’s deterministic destruction