layers-conceptual-model

Installation
SKILL.md

/layers-conceptual-model

Assumes /layers-intro has been loaded for framework context.

The conceptual model is the most neglected load-bearing layer. It defines the objects the product recognises, their relationships, what states they can be in, and the vocabulary used for everything. It lives in the solution space: it is not a capture of users' existing mental models (which are contradictory and messy — that's the domain layer's job), but a deliberate design decision about how the product will model its domain.

What it is — and isn't:

  • A design decision that resolves the messy domain into a coherent, opinionated structure
  • Not a database schema — engineers make their own data decisions, but the gap between this model and what they build matters. A large, unexamined gap is both UX debt (users encounter a product that contradicts the model) and technical debt (the system is harder to evolve).
  • Not a wireframe or flow — no screens, no navigation. Those belong to the layers above.
  • Not neutral — every naming decision, every relationship boundary, every included or excluded object reflects a point of view.

Decisions this layer needs to make:

  • What objects will this product recognise, and what are their boundaries?
  • How do those objects relate to each other?
  • What can users do with each object?
  • What states can each object be in, and what transitions matter?
  • What is the product's vocabulary — one name per concept, chosen and committed to?
Related skills
Installs
189
GitHub Stars
32
First Seen
11 days ago