Studio Matrx Monthly · Volume 1 · Issue 4 · September 2026
Amogh N P
 In loving memory of Amogh N P — Architect · Designer · Visionary 
Machine-Readable RegulationLesson 3.3
Automated Compliance & Rules-as-Code/Module 3 · Rules as Code

Lesson 3.3 · Rules as Code

Machine-Readable Regulation

Prose is written for a human mind that fills gaps and tolerates ambiguity; a machine needs structure, defined terms, explicit formats and versioning - this lesson maps what 'machine-readable' really demands, and how wide the gap from an ordinary paragraph of regulation actually is

12 min Interactive lessonFree · open lessonByAmogh N P· Architect & interior designer
The hook

A regulation you can read is not a regulation a computer can run. What has to change about the rule itself before a machine can evaluate it?

We have talked about encoding a single rule and about the idea of giving regulation an executable form. But there is a step underneath both that is easy to skip: for any of it to work, the regulation itself has to become something a machine can actually read. A paragraph of prose in a byelaw is written for a human mind - one that knows what a corridor is, fills in undefined terms, tolerates a little vagueness, and quietly supplies the context the words assume. A computer brings none of that. To evaluate a rule it needs the rule in a form with explicit structure, precisely defined terms, a data format it can parse, and a clear statement of which version of the rule this even is.

That is what 'machine-readable' means, and it is a bigger demand than it first sounds. It is not enough to put the code in a searchable PDF, or even to retype it into a database; the rule must be restructured so that every part a machine needs - what it applies to, what it measures, in what units, against what value - is explicit and typed, and every term it leans on is defined. This lesson maps those requirements and, just as importantly, measures the gap: how far an ordinary paragraph of regulation is from a form a computer can run, why closing that gap is real human work, and who has to do it. Understanding the gap is what keeps you honest about how much regulation is actually machine-ready today, especially in India.

Digital PDF != machine-readable. Need: structure + defined terms + shared format + versioning. Some of the rule ('adequate', 'suitable') never crosses the gap - it was judgement all along.

What it means

'Machine-readable' means far more than a searchable PDF

It is tempting to think a regulation is machine-readable once it exists as a digital file - a PDF of the byelaw, say, that you can search and copy from. It is not. A PDF is readable by a human on a screen; the computer sees a bag of characters with no idea which are a rule, which a heading, which a footnote, or what any of them mean. Machine-readable, in the sense automated compliance needs, means something much stronger: the rule is represented so that a program can identify its parts, understand their types, and evaluate its condition without a human interpreting anything at run time.

Concretely, that means a rule must be broken into explicit, labelled components - the same anatomy from lesson 3.1, now made into data a machine can parse. Which occupancy does this apply to? Which element does it govern? Which property, in which units? What comparison, against what value? A machine-readable rule states each of these as a distinct, typed field, not as a clause a reader must untangle. It also means the terms the rule uses point to definitions the machine can resolve: 'clear width' is not a phrase to be understood but a defined, computable quantity; 'assembly' is not a word but one value in a defined set of occupancy classes.

The contrast with prose is the whole point. Prose is optimised for a human reader: it is compact, it relies on shared background, it tolerates - even uses - ambiguity, and it trusts the reader to bring judgement. Machine-readable form is optimised for a program: it is explicit, typed, defined, and structured, because the program brings no judgement at all. Neither is 'better'; they serve different readers. The mistake that wastes real effort is assuming that digitising the prose - scanning it, searching it, even neatly reformatting it - has made it machine-readable. It has not. Making a regulation machine-readable is a restructuring of the rule into an explicit, defined, typed, versioned form, and it is that restructuring, not the file format, that lets a computer evaluate it. Everything else in this lesson unpacks what that restructuring requires.

The gap: from a paragraph to an evaluable form PROSE (a human mind fills gaps) Adequate means of egress shall be provided from every assembly space, of suitable width for the occupant load. - undefined terms - no data types or units - no structure to parse - which edition? unclear THE GAP real human work MACHINE-READABLE FORM rule_id: egress-width-assembly version: 2026-ed applies_if: occupancy = assembly element: exit_route property: clear_width [unit: m] required: occupant_load * 0.005 operator: >= defined_terms: {clear_width, occupant_load, assembly} structured - typed - defined - versioned
Zoom
The gap between a paragraph of prose regulation - undefined terms, no types, no version, a human mind assumed - and a machine-readable form that is structured, typed, defined and versioned. Bridging it is real human work, and part of the rule may never cross.
Ingredients

Structure, definitions, formats - the ingredients of a readable rule

A machine-readable rule needs several ingredients working together, and it is worth naming them because a gap in any one breaks the whole. The first is structure: the rule must be split into parseable parts - scope, element, property, operator, value, action - rather than left as one flowing sentence. Structure is what lets a program find the pieces it must evaluate instead of guessing at grammar. The second is unambiguous definitions: every term the rule leans on must be pinned to a single, explicit meaning. What exactly is a corridor? How is clear width measured, and clear of what? What units - metres, millimetres? Which occupancy classes exist, and what puts a space in one? Prose can leave these to a trained reader; a machine-readable rule cannot, so the definitions must travel with the rule, resolvable by the program.

The third ingredient is a format: a defined, consistent data representation that software can actually read and exchange - typed fields, explicit units, references between rules and definitions - so that different tools interpret the same encoded rule the same way. This is where interoperability lives: without a shared, well-defined format, every tool invents its own, and an encoded rule cannot move between them. A machine-readable regulation, done well, is not just structured for one program but expressed in a form many programs can consume consistently, ideally leaning on shared classifications and vocabularies rather than private ones.

Underneath these sits a demand the prose rarely made explicit: the rule must connect to a shared understanding of the things it talks about. A width check is meaningless unless 'the model' and 'the rule' agree on what a corridor, a door, a room, an occupancy actually are - a common vocabulary of building elements and properties. This is why machine-readable regulation is entangled with the data standards of the model it will check against: the rule's defined terms and the model's classifications have to line up, or the rule finds nothing to test. Structure, definitions and format make a rule readable in principle; agreement with the model's vocabulary makes it runnable in practice. Both are real work, and both are places the effort quietly fails when skipped.

What makes a regulation machine-readable 1. STRUCTURE Rules split into parseable parts: scope, element, property, condition, value - not one flowing paragraph of prose. 2. UNAMBIGUOUS DEFINITIONS Every term pinned to one meaning: what a corridor is, how clear width is measured, what units, what occupancy classes exist. 3. FORMATS A defined data format a program can read (not a scanned PDF): typed fields, units, references - consistent and interoperable. 4. VERSIONING Which edition, in force from when: rules change, so each encoded rule must carry its version and effective date, or it misleads.
Zoom
Four ingredients that make a regulation machine-readable: explicit structure, unambiguously defined terms, a shared data format, and versioning. A gap in any one breaks the check - and versioning is first-class, not bookkeeping.
Versioning

Versioning: which rule, in force as of when

There is one ingredient of machine-readable regulation that is easy to forget and dangerous to skip: versioning. Regulations are not fixed. The National Building Code is revised; municipal byelaws and development-control regulations are amended, sometimes frequently and locally; IS standards are updated and occasionally withdrawn and replaced. A rule that was correct last year may have a different threshold, a different scope, or no force at all this year. For a human reading the prose this is manageable - they check which edition applies. For a machine running an encoded rule it is invisible unless the version is part of the data.

So a properly machine-readable rule must carry, as explicit fields, which regulation and edition it encodes and from when it is in force - and, ideally, which version it was superseded by. Without this, an encoded rule is a claim with no date on it: the tool confidently checks a design against a threshold that may already have changed, and returns a clean 'pass' that is quietly out of date. This is not a corner case. Because encoded rules are reused across many projects and tools, a stale encoding scales its staleness - one wrong, un-versioned rule can silently mislead every design that runs against it, and no one sees the error because the tool still returns a tidy verdict.

Versioning also underwrites accountability and trust. When a rule is versioned, you can ask the essential questions: which edition of the byelaw does this check implement, when was it last updated against the source, and does it match what the authority is actually applying today? A machine-readable regulation without versioning cannot answer those, and an answer you cannot get is a risk you cannot manage. This is one of the strongest practical reasons the authoritative rule must always remain the actual, current code and byelaw: the encoded version can drift, and only by keeping the live regulation as the reference can that drift be caught. Treat any encoded rule you rely on as suspect until you know its version and its currency - and treat versioning not as metadata bookkeeping but as a first-class part of what 'machine-readable' has to mean.

What makes a regulation machine-readable 1. STRUCTURE Rules split into parseable parts: scope, element, property, condition, value - not one flowing paragraph of prose. 2. UNAMBIGUOUS DEFINITIONS Every term pinned to one meaning: what a corridor is, how clear width is measured, what units, what occupancy classes exist. 3. FORMATS A defined data format a program can read (not a scanned PDF): typed fields, units, references - consistent and interoperable. 4. VERSIONING Which edition, in force from when: rules change, so each encoded rule must carry its version and effective date, or it misleads.
Zoom
Four ingredients that make a regulation machine-readable: explicit structure, unambiguously defined terms, a shared data format, and versioning. A gap in any one breaks the check - and versioning is first-class, not bookkeeping.
The gap

The gap between prose and an evaluable form - and who bridges it

Put the ingredients together and you can see the size of the gap between an ordinary paragraph of regulation and a form a machine can evaluate. Take a real prose clause - 'adequate means of egress of suitable width shall be provided from every assembly space for the occupant load' - and try to make it machine-readable. You must define 'adequate' and 'suitable' (or admit they cannot be defined and mark the rule as not fully checkable), fix how occupant load is determined, decide which elements are 'means of egress', settle the units and the formula relating width to load, structure it all into typed fields, and stamp it with a version. What looked like one sentence becomes a substantial piece of structured, defined, versioned data - and part of it, the 'adequate' and 'suitable', may not cross the gap at all, because it was judgement in the first place.

This is why machine-readable regulation is genuine, ongoing human work, not a one-time conversion you can automate away. Someone must do the structuring, resolve or flag every definition, choose the format, align the terms with the model's vocabulary, and maintain the versioning as the source changes. Every one of those steps involves the interpretive choices of the previous lessons, which is why the gap is not just technical but governance-laden: bridging it means deciding what the rule means and keeping that decision current and transparent.

The Indian context makes the gap concrete. Byelaws vary enormously across thousands of urban local bodies, are amended on their own schedules, and are often published as prose documents, not structured data; many building submissions are still 2D drawings rather than structured models with a shared vocabulary. So while the quantitative development-control rules are exactly the kind that could be made machine-readable - and approval-digitisation is steadily doing this for parameters like setbacks, coverage and FSI - the honest picture is that most regulation is not machine-ready today, and making it so is a large, distributed effort. Knowing the gap keeps you realistic: automated checking reaches only as far as regulation has actually been made machine-readable, and the authoritative rule remains the live prose code, bridged to machine form by accountable humans.

The gap: from a paragraph to an evaluable form PROSE (a human mind fills gaps) Adequate means of egress shall be provided from every assembly space, of suitable width for the occupant load. - undefined terms - no data types or units - no structure to parse - which edition? unclear THE GAP real human work MACHINE-READABLE FORM rule_id: egress-width-assembly version: 2026-ed applies_if: occupancy = assembly element: exit_route property: clear_width [unit: m] required: occupant_load * 0.005 operator: >= defined_terms: {clear_width, occupant_load, assembly} structured - typed - defined - versioned
Zoom
The gap between a paragraph of prose regulation - undefined terms, no types, no version, a human mind assumed - and a machine-readable form that is structured, typed, defined and versioned. Bridging it is real human work, and part of the rule may never cross.
Verify-this: readable means structured, defined, formatted and versioned - not just digital

Machine-readable is not digitised

PDF versus evaluable form

A searchable file is not a runnable rule. Machine-readable means the rule is restructured into explicit typed parts a program can parse and evaluate without interpreting at run time. Modules 3.1, 5.3.

Definitions must travel with the rule

Unambiguous terms and vocabulary

Every term (corridor, clear width, occupancy, units) must be pinned to one meaning and line up with the model's vocabulary, or the rule finds nothing to test. Modules 5.3, 5.4.

Versioning is first-class

Which edition, in force when

Rules change; an un-versioned encoding silently checks against stale thresholds and scales that staleness. Each rule must carry its edition and effective date. Modules 3.4, 8.2.

Hands-on workshop

Workshop - measure the gap by making one clause machine-readable on paper

You feel how wide the prose-to-machine gap is only by trying to cross it. In this workshop you take one real prose clause and rewrite it as a machine-readable rule - structured, defined, versioned - and honestly mark the parts that will not cross.

One real clause and a notebook. No software - the aim is to feel the gap between prose and an evaluable form by hand; making regulation truly machine-readable is a large collective effort, and binding compliance stays with the professional, the authority and the actual current code.

Given & goal
Goal: convert one prose clause toward machine-readable form and expose the gap
Inputs: one real regulation clause (ideally with a mix of quantitative and vague language) plus a notebook
Time: ~45 minutes
  1. 1Write out one prose clause exactly. Underline every term that a machine could not simply 'know' (corridor, clear width, adequate, occupancy, suitable, etc.).
  2. 2Restructure it into explicit typed fields: applies_if (scope), element, property with units, operator, required value, action. Put each on its own line.
  3. 3Write a definition for each underlined term - or, where you cannot define it precisely, mark it NOT CHECKABLE and say why (it is judgement, needs analysis, or needs facts outside the model).
  4. 4Add versioning: state which regulation and edition this encodes and from when it is in force, and note how you would know if it changed.
  5. 5Write a short reflection estimating how much of the clause crossed the gap cleanly, how much did not, and why the live prose code stays authoritative and interpretation stays human - flagged as reasoning.

You’ll walk away with
A one-page conversion: a prose clause, its restructured machine-readable fields, a definition or NOT-CHECKABLE mark for each term, a version stamp, and a reflection measuring the gap - framed as reasoning, not a compliance determination.

The worked example

Three altitudes on the same idea

Read the band that fits you — or all three.

For the architectUsing automated checking for early feedback and self-checking - while you and the authority stay accountable

A rule can only be auto-checked as far as the regulation behind it has actually been made machine-readable - structured, defined, formatted and versioned - so temper your expectations of any tool by asking what it really encodes and how current it is. For clear quantitative development-control rules (setbacks, coverage, FSI, height) machine-readable form is achievable and increasingly real in online approval systems; for prose clauses full of undefined or judgement-laden terms, much of the rule never crosses the gap. Two practical habits: check that an encoded rule carries a version and effective date before trusting it, and remember that the rule's terms must line up with your model's vocabulary or the check finds nothing. You and the authority stay accountable; the authoritative rule is the live, current byelaw and NBC, never a possibly-stale machine-readable copy, and binding interpretation stays with you, the authority and the law.

For the interior designerWhere automated rule-checking helps interiors (accessibility, fire, egress) and where judgement is required

The interior rules that can be auto-checked are the ones already made machine-readable - defined, typed, versioned - which is a smaller set than it looks, so know the gap. Quantitative accessibility and egress rules (door and route clear widths, turning space, aisle widths, exit counts, travel distances) can be structured into machine-readable form and are worth checking early. But this only works if terms are defined consistently (clear opening measured how? which route is the accessible one?), if the encoded rule matches the current standard, and if your model's elements carry the matching vocabulary. Prose full of 'adequate' and 'suitable' will not fully cross the gap. Treat machine-readable checks as covering the measurable slice, ask about definitions and versions, and keep the judgement real usability needs. Binding fire, egress and accessibility compliance stays with the qualified professionals, the authority and the current governing code (NBC India, accessibility standards).

For the studentHow regulations become machine-readable rules - and why many rules resist being coded at all

This lesson answers a question students often skip: what has to be true of a regulation before a computer can run it at all? The answer is that 'machine-readable' means far more than a digital PDF. It means the rule is restructured into explicit, typed parts (scope, element, property, units, operator, value), that every term is pinned to an unambiguous definition, that it lives in a defined data format tools can share (interoperability), and that it is versioned so you know which edition and when. Learn to see the gap between a paragraph of prose - written for a human who fills gaps and tolerates ambiguity - and an evaluable form, and to notice that part of many rules (the 'adequate', the 'suitable') never crosses that gap because it was judgement to begin with. Bridging the gap is real, ongoing human work laden with interpretive choices, which is why automated checking reaches only as far as regulation has actually been made machine-readable - and why the live prose law stays authoritative.

Misconception check

Building codes are already digital - they are published as PDFs and hosted online, and many are in searchable databases - so the hard part of machine-readable regulation is basically done. To automate checking you just point the software at the digital code and let it read the rules.

A digital file is not a machine-readable rule, and conflating the two badly underestimates the work. A PDF or a searchable database of the byelaw is readable by a human on screen, but to the computer it is unstructured text: it cannot tell which characters form a rule, what the rule applies to, what property it constrains, in what units, or against what value, and it cannot resolve the terms the rule uses. Making a regulation machine-readable in the sense automated compliance needs is a restructuring, not a reformat: each rule must be broken into explicit, typed components (scope, element, property, operator, value, action), every term it leans on must be pinned to an unambiguous definition, it must live in a defined data format that tools can share and interpret consistently, its terms must line up with the vocabulary of the model it will check, and it must be versioned so you know which edition it encodes and whether that is still in force. All of this is genuine, ongoing human work, laden with the interpretive choices earlier lessons described - and part of many rules (the 'adequate', the 'suitable', the performance clauses) never fully crosses the gap because it was judgement, not computation, in the first place. So automated checking reaches only as far as regulation has actually been made machine-readable, which today - especially across India's thousands of locally varying, prose-published byelaws - is a limited and unevenly maintained subset. The authoritative rule is always the live, current prose code and byelaw, bridged to machine form by accountable humans, never a possibly-stale digital copy the software happened to read.
Try it

Do it yourself

No software needed - reason it through.

  1. 1Why is a searchable PDF of a byelaw not the same as a machine-readable rule?
  2. 2List the ingredients a rule needs to be machine-readable (structure, definitions, format, versioning) and say what each one does.
  3. 3Take 'adequate egress of suitable width for the occupant load' and mark which parts could cross the gap to machine form and which could not, and why.
  4. 4Why is versioning dangerous to skip, and how does an un-versioned encoding scale its own staleness?
  5. 5In the Indian context, name two reasons most building regulation is not machine-ready today.
Take this with you

The one line to carry out

Machine-readable regulation means far more than a digital PDF: the rule must be restructured into explicit, typed parts, its terms pinned to unambiguous definitions that line up with the model's vocabulary, expressed in a shared format, and versioned so you know which edition is in force - and part of many rules never crosses that gap because it was judgement to begin with; bridging it is ongoing, interpretive human work, so automated checking reaches only as far as regulation has actually been made machine-readable, and the live prose code stays authoritative.
Take it further
References & further reading

Peer-reviewed journals & authoritative standards

  1. 01Rules as codeWikipedia - Rules as code, 2026.
  2. 02Computational lawWikipedia - Computational law, 2026.
  3. 03InteroperabilityWikipedia - Interoperability, 2026.
  4. 04Semantic data modelWikipedia - Semantic data model, 2026.
  5. 05National Building Code of IndiaWikipedia - National Building Code of India, 2026.
Related lessons
Recap
For automated checking to be possible at all, the regulation itself must become something a computer can read - and that is a far higher bar than being digital. A searchable PDF is readable by a human but is unstructured text to a machine, which cannot tell a rule from a heading or resolve any of its terms. Machine-readable regulation means the rule is restructured into explicit, typed components (scope, element, property with units, operator, value, action), every term it uses is pinned to an unambiguous definition, it lives in a defined data format that tools can share and interpret consistently, its vocabulary lines up with the model it will check, and it is versioned so you know which edition it encodes and whether that edition is still in force. Skipping versioning is especially dangerous, because reused encodings scale their own staleness - one out-of-date rule silently misleads every design that runs against it while still returning a tidy verdict. Trying to make a real prose clause machine-readable shows the size of the gap: undefined and judgement-laden terms ('adequate', 'suitable') may never cross it, because they were judgement rather than computation to begin with. Bridging the gap is genuine, ongoing human work laden with interpretive choices, so automated checking only reaches as far as regulation has actually been made machine-readable - a limited, unevenly maintained subset today, especially across India's thousands of locally varying, prose-published byelaws - and the authoritative rule is always the live, current prose code, bridged to machine form by accountable humans.
Carry forward →

Bridging the gap - structuring, defining, versioning and interpreting a rule into machine-readable form - is done by someone. Who that someone is, and why it matters so much, is the governance question we turn to next.

A

The author

Amogh N P

Architect, interior designer, and creative polymath. Studio Matrx began in his notebooks — his vision of design made honest, useful, and open to everyone. Its Academy is written and taught in his memory, and free, forever.

More about Amogh →