| name | spatial-reasoning-fundamentals |
| description | Spatial reasoning fundamentals for three-dimensional thinking, coordinate navigation, mental rotation, cross-section visualization, and voxel geometry. Covers the cognitive primitives that underlie block-based world-building, CAD modeling, volumetric design, and VR/AR navigation — egocentric vs allocentric frames, cardinal orientation, chunk boundaries, symmetry classes, and the translation between paper blueprint and in-world construction. Use when teaching or applying 3D spatial thinking in any spatial computing context. |
| type | skill |
| category | spatial-computing |
| status | stable |
| origin | tibsfox |
| modified | false |
| first_seen | "2026-04-12T00:00:00.000Z" |
| first_path | examples/skills/spatial-computing/spatial-reasoning-fundamentals/SKILL.md |
| superseded_by | null |
Spatial Reasoning Fundamentals
Spatial reasoning is the cognitive substrate beneath all spatial computing. Whether the user is placing blocks in a voxel world, sketching in a CAD program, navigating a VR environment, or planning a building from a blueprint, the same core abilities are in play: holding a three-dimensional model in working memory, translating between viewpoints, and predicting how geometry behaves under transformation. This skill catalogs the cognitive primitives, failure modes, and teaching heuristics that make spatial reasoning transferable across spatial computing platforms.
Agent affinity: sutherland (coordinate frames and display geometry), engelbart (navigation and viewpoint), papert-sp (constructionist scaffolding)
Concept IDs: spatial-coordinate-navigation, spatial-reasoning-3d, spatial-geometric-structures
The Cognitive Primitives
| Primitive | What it is | Why it matters |
|---|
| Coordinate framing | Anchoring position to an origin plus three axes | Without a frame there is no "here" and no "there" |
| Mental rotation | Rotating an object in imagination to compare with a target | Every build-from-reference task requires it |
| Cross-section visualization | Slicing a solid to see what the interior looks like | Essential for multi-floor planning and engineering |
| Viewpoint translation | Converting between first-person, top-down, and isometric views | The reason blueprints work |
| Scale invariance | Understanding that proportions are preserved under uniform scaling | Pixel art enlargement, terrain mapping |
| Symmetry detection | Recognizing reflection, rotation, and translation symmetries | Halves the work in any symmetric build |
| Path planning | Choosing a route through a 3D environment | Navigation, redstone wiring, logistics |
These primitives are not independent. A skilled builder uses them in combination — rotating a referenced structure mentally (mental rotation) while slicing it floor by floor (cross-section) and projecting to a top-down sketch (viewpoint translation).
Coordinate Systems and Orientation
Every spatial computing platform imposes a coordinate system. The skill of orienting oneself within that system is the entry point to all further work.
Right-handed vs left-handed
Most 3D systems use a right-handed coordinate system: X points east, Y points up, Z points south (or north — conventions vary). Confusion arises when tools disagree. Unity is left-handed; Unreal is left-handed; Minecraft is right-handed with Y as vertical; most CAD tools use Z vertical. The teaching move is to make the convention explicit and to have the learner physically gesture the axes before placing anything.
