DE — heise online
RUML file format translates laws into machine-readable logic
Policy2 min read
Berlin-based Rulemapping Group has released RUML, an open file format that stores the checking rules of laws so software can read and run them. A new company, Law as Code Institut GmbH, publishes the format.
A new format for laws that machines can read
The Berlin company Rulemapping Group has published RUML, a free format for saving the rules that check whether a law is being followed. Software can read these rules directly. The roughly 200-page specification (version 1.0.0) has been online at ruml.org since Monday. The publisher is Law as Code Institut GmbH, a company founded at the same time as the specification. Its leaders also lead Rulemapping Group. Stephan Breidenbach, founder of Rulemapping Group and creator of its method, is also involved.
Key facts
- The specification is about 200 pages long and is at version 1.0.0.
- In April 2025, the federal agency SPRIND (Agency for Disruptive Innovation) helped lead a funding round of 12 million euros for Rulemapping.
- The official launch of the format and the institute is set for 24 November, with a livestream.
- Rulemapping's initial catalog of machine-readable laws starts with 50 laws.
How RUML works
A RUML file is a JSON document, a common text format for structured data. It has fields for the format name, the spec version, metadata, and a rulemap. The rulemap is a tree of checks, linked by six logic operators. Authors write expressions in JSONata, a query language for JSON. Parts of the tree can be reused as modules. A companion format, RUML-Result, records the outcome of a check. RUML stores only the checking logic and points to the matching legal text, unlike the XML standard Akoma Ntoso, which marks up the law text itself. The goal is to let authorities update their software when a law changes, like a software update, instead of each office changing its systems separately with different interpretations.
Why it matters
When lawmakers change a rule, agencies and IT firms usually update each affected system by hand, and they may read the rule differently. A shared, machine-readable source could make these updates consistent and faster. Still, there is no binding European standard for machine-readable law yet. The company keeps control of the format, and it has filed a patent and an EU trademark, so people should watch how open the standard really is.
What to watch
- The official launch and livestream on 24 November.
- Whether the planned open-source version of the Rulemap Builder editor is released.
- Results of the Thuringia pilot, which started in 2025 to speed up building permits.
- Whether a European standard for machine-readable law develops, and whether the format stays open to outside changes, since pull requests are not accepted yet.
Glossary
- RUML
- An open file format that stores the checking rules of laws so software can run them.
- Rulemapping Group
- A Berlin company that developed RUML and a method for turning laws into machine-readable rules.
- Law as Code Institut GmbH
- The company that publishes the RUML specification and was founded alongside it.
- SPRIND
- The German federal agency for disruptive innovation that funds risky new technology projects.
- JSONata
- A query language for writing expressions that pull and transform data in JSON files.
- Akoma Ntoso
- An XML standard used to mark up the text of laws and other legal documents.