Fundamentals

What Is Model-Native Architecture? Why the Model Is the Product, Not the Diagram

Model-native architecture treats the model as the product and the diagram as one disposable view of it. Here's what that means in practice.

Stable Identity: Why Architecture Models Need IDs That Survive a Rename

Every architecture element needs a machine ID separate from its name, so a rename stays a rename instead of silently breaking its relationships and views.

Views Without Duplication: How One Model Produces Many Diagrams

One canonical model can produce many diagrams because a view is a live query over shared elements, not a copy of them.

The Canonical Model Pattern: A Neutral Core Between Tools, Canvas and AI

Canvas and AI both edit the same model, not two copies of it. Here is how a canonical core with stable IDs makes that possible.

Round-Trip Fidelity: Why Import Then Export Should Never Lose Data

What survives an architecture tool's import/export round trip, and why GUIDs, folders and diagram geometry keep getting silently dropped.

Model Validation: Catching Broken Architecture Before It Ships

Architecture models break in four distinct ways, and each needs a different check. A layered look at structural validation, metamodel validation, governance rules and linting — plus the honest limit of all four.

Semantic Diff: Reading a Model Change Like a Sentence, Not a Pixel Delta

A plain-text diff on an architecture file shows lines changing. A semantic diff explains what the change means to the model, the views, and the rules.

Deterministic Serialization: Making Architecture Models Git-Friendly

Why architecture models need deterministic, stable-ordered serialization to be reviewable in pull requests and mergeable by more than one architect.

Visual and AI: Two Ways Into One Model

The same architecture change, made twice: once by dragging on a canvas, once by asking an AI assistant. What each mode is genuinely good at, where each one hurts, and why it matters that both write to the same model.

ArchiMate & EA Practice

ArchiMate for Beginners: Layers, Elements and Relationships Explained

A practical, accurate primer on ArchiMate's three core layers, main element types, and the ten relationship types that hold a model together.

Business, Application, Technology: Reading an ArchiMate Layered View

How to read a layered ArchiMate view: what crosses layers, what the arrows mean, and how to spot gaps between business need and technology support.

Choosing the Right ArchiMate Viewpoint for Your Audience

ArchiMate defines viewpoints for different audiences and questions. See why each one is really a filter over one model, not a diagram to maintain by hand.

Application Landscape Diagrams That Executives Actually Read

Most application landscape diagrams fail executives before the meeting starts. Here's what actually communicates, and how to keep it from going stale.

Writing Architecture Rules That Governance Teams Can Enforce

A written principle and an enforceable rule look alike on paper. Only one is a deterministic query a machine checks on every model change.

Impact Analysis: What Happens If We Retire This Application?

Every architect gets asked 'what breaks if we retire this?' Here's what a complete impact analysis requires, and why it's a graph query, not a search.

Domain Boundaries and Why Databases Shouldn't Cross Them

Direct cross-domain database access is the architecture smell that never shows up in a review. Here's why it happens and how to actually stop it.

From Business Capability to Application Component: Traceability in Practice

Capability maps are easy to draw and easy to fake. Here's how to make the capability-to-component chain a real, queryable trace instead of a slide.

Architecture Linting: The Quality Checks Most EA Repositories Skip

Why architecture models need a linter, not just governance rules: the checks EA repositories skip and why running them on every save matters.

C4 & Software Architecture

The C4 Model Explained: Context, Container, Component, Code

A practical primer on the C4 model: what Context, Container, Component, and Code diagrams each answer, and why they are zoom levels of one system.

When to Use C4 Instead of ArchiMate (and When to Use Both)

ArchiMate gives portfolio-wide governance; C4 gives fast, developer-friendly depth on one system. When to use each, and when to legitimately use both.

Documenting a Microservices Architecture Without Drowning in Diagrams

Why the all-services diagram and per-team diagrams both fail as microservices grow, and how modelling services once with scoped views fixes it.

API Gateways, Service Boundaries and the Diagrams That Explain Them

Why API gateways silently accumulate bypass integrations, and how a checkable rule against the real dependency graph catches them before an incident does.

Solution Architecture Documents That Survive the First Code Review

Why solution architecture documents go stale within weeks of approval, and how Git-native, PR-reviewed models keep them true.

Modelling Integration Points Before You Build Them

Model a new integration as a relationship before you build it: direction, protocol, ownership, and failure mode, checked before code is written.

Migration & Interoperability

Migrating from Sparx Enterprise Architect: A Practical Guide

A practical guide to migrating from Sparx EA: what actually needs to move, what round-trips cleanly, and why a phased rollout beats a big-bang cutover.

Migrating from Archi: What Round-Trips and What Doesn't

Archi is already ArchiMate-native, so migrating to Mooodels isn't about whether you can model something. It's about exactly what survives the trip.

The Hidden Cost of Vendor Lock-In in Enterprise Architecture Tools

Proprietary formats, seat licensing, bundled AI vendors, and single-client tools carry a cost that only shows up when you try to leave.

Exporting Architecture Back to Sparx EA Without Duplicating Objects

Why naive round-trip pipelines duplicate every object on re-import, and how identity-preserving export avoids it by reusing the original Sparx GUID.

GUID Matching Explained: How Re-Import Updates Instead of Duplicates

Names change and files get reordered, but a GUID minted once by the source tool doesn't. Here's how re-import identity matching actually works, honestly.

Folder Structures, Specializations and the Metadata Most Tools Throw Away

Import wizards map what fits their metamodel and quietly drop the rest. Here's what actually gets lost, and the extension-bag pattern that fixes it.

What to Check Before Trusting an Architecture Import

An import that reports success has told you it didn't crash, not that it's correct. A practical verification checklist for the hour after you pull an existing repository into a new tool.

Keeping Architecture in Git: Branching, Reviewing and Merging Models

What it takes to branch, review, and merge an architecture model the way a team merges code — and where a model merge still needs a human to make the call.

AI in Architecture

Why AI Shouldn't Edit Your Architecture Model Directly

AI keeps getting better at writing code and prose. That's not a reason to let it write directly into your architecture model. Here's why the gap stays.

The ModelPatch Pattern: Structured, Reviewable AI Changes

A closed set of typed, validated operations is what makes AI-proposed model changes safe to preview, validate, and approve before they ever apply.

Prompting an Architecture Assistant: What Good Instructions Look Like

A vague instruction to a model-editing AI produces a patch you must review, not a disappointing paragraph. Here's how to write instructions that don't.

Bring Your Own AI: Provider Choice as an Architecture Requirement

AI provider choice belongs on the same evaluation checklist as data residency and access control — not a settings-page afterthought. Here's why.

AI Sovereignty for Public-Sector and Regulated Architecture Teams

AI sovereignty is a property of a deployment, not a vendor label. A concrete breakdown of what public-sector architecture teams need to control it.

Context Efficiency: Why AI Shouldn't See Your Whole Repository

Sending a whole architecture repository to an AI is slow, costly, and a data-exposure risk. Query the graph first, then hand over just the relevant slice.

Where AI Helps in Architecture Work (and Where It Still Can't)

A specific, honest inventory of where AI genuinely speeds up architecture work today, and where the judgment still has to be yours.

Reviewing an AI-Generated Architecture Change Like a Pull Request

AI-proposed architecture changes deserve the same discipline as a code pull request: read the diff, check the description matches, don't rubber-stamp.

Practice & Strategy

Enterprise Architecture Tools Compared: Repository vs Model-Native Approaches

A practical framework for comparing EA tools: repository vs. diagrams, installed vs. browser, methodology, AI, format lock-in, and licensing.

Why Diagramming Tools Aren't Architecture Tools

A diagramming tool draws boxes and arrows well. Architecture needs something that knows what the boxes mean. Here's exactly where the gap shows up.

Architecture Governance for Teams Without a Dedicated EA Function

You don't need an enterprise architecture team to get real governance value. A practical path for teams without one, starting from what exists.

Solution Architects vs Enterprise Architects: Where the Model Overlaps

Solution and enterprise architecture are usually run as separate disciplines with separate tools. In practice they're two zoom levels on the same facts.

Choosing an Architecture Tool for a Public-Sector Project

A due-diligence checklist for public-sector teams evaluating architecture tools: data residency, AI controls, open exchange formats, auditability, and TCO.

Architecture Documentation That Doesn't Rot Six Months Later

Architecture documentation goes stale because it's a separate artifact on a separate cadence. Four practices that make it structurally hard to skip.

Running Architecture Reviews Using a Live Model Instead of Slides

Slide decks answer the questions you prepared for. A live, queryable model answers the ones you didn't. Here's how to run a review either way.

Search and Query: Finding the One Application That Matters in a Big Model

Visual scanning of diagrams breaks down as a model grows. How structured search and graph queries replace 'ask the person who remembers'.

From Whiteboard to Model: Capturing Architecture Decisions as They Happen

Most architecture decisions die on a whiteboard or get written up days later from memory. Capture them as real model changes in the same session instead.

Building an Architecture Practice Around Semantic Models, Not Slide Decks

What changes operationally when a practice makes the model, not the deck, the source of truth, and a realistic path to get there from slides.