Literate model

A Literate Model is a “readable model” that integrates model structure with natural-language narrative (structured documentation).

It extends the idea of literate programming into the modeling domain, unifying structure (model) and narrative (structured text) into a single intelligible artifact interpretable by both humans and AI.

The concept of “Literate Modeling” has been explored previously by some researchers and developers, mostly as an approach to improve documentation or code comprehension. However, those attempts did not establish a systematic modeling methodology that integrates models, narrative, and AI assistance as a unified framework.

The Literate Model is a modeling concept newly systematized and proposed by SimpleModeling for the AI era. Building upon the ideas of literate modeling, it redefines them as an intelligent modeling foundation that enables AI-collaborative knowledge circulation and model generation.

It is not merely a modeling technique but a framework that embeds human reasoning and design intent as narrative within the model, enabling AI to analyze and reconstruct them to assist in design and generation.

In SimpleModeling, the Literate Model is realized through its proprietary descriptive ecosystem based on CML (Cozy Modeling Language) and SmartDox. CML allows model elements—such as entities, value objects, rules, and state machines— to coexist with their explanatory narratives within the same document, ensuring that the “model” and its “narrative” evolve in harmony.

The Literate Model also serves as a central artifact connecting DSL-driven development, Component-Based Development (CBD), and the Body of Knowledge (BoK), providing a foundation for AI-assisted model understanding, generation, and optimization.

The Literate Model proposed by SimpleModeling represents a new modeling paradigm in which AI can read, write, and generate models alongside humans.