stacklok/modelith

Modelith is a set of tools for authoring, validating, and rendering domain models, meaning a plain language description of what a system actually is: its concepts, how they relate to each other, and the rules that govern them. A domain model is stored as a YAML file, but the README stresses that you are not expected to write that YAML by hand. Instead you describe your system in plain language to an AI agent, the agent drafts and validates the YAML, then renders it into a Markdown document with embedded diagrams that you commit alongside your code. The typical workflow starts with describing concepts in plain language to a Claude Code skill, which writes or updates the YAML file. The modelith command line tool then lints that file for validity and completeness, which can be wired into continuous integration as a gate, and renders it into a Markdown file with Mermaid diagrams that stays committed in the repository, continuous integration regenerates that Markdown and fails the build if it has drifted from the YAML source, similar to a generated code check. Getting started requires two pieces installed in order: the command line tool itself, which can be installed with Homebrew, downloaded as a prebuilt binary from the releases page, or built from source with Go, and the Claude Code plugin that provides the conversational skills, since those skills call out to the binary. The plugin's marketplace listing was still awaiting approval at the time of writing, so the README explains an alternative install path through a skills package manager that works today with Claude Code as well as other AI coding tools. Once installed, you invoke a specific command inside Claude Code and describe your domain in conversation, and the agent asks questions, drafts the YAML, lints it, and keeps the rendered Markdown synchronized. A domain model file is self describing, declaring its own kind and version, and organizes information into four sections: a glossary, enums, entities, and scenarios, with entities able to declare invariants such as rules a system must always uphold. The project describes itself as early stage, with the schema, command line interface, output format, and documentation still open to breaking changes, and it welcomes feedback and issues. It is released under the Apache 2.0 license.