{"id":23740,"date":"2025-09-04T10:00:00","date_gmt":"2025-09-04T08:00:00","guid":{"rendered":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/?p=23740"},"modified":"2025-10-24T13:44:05","modified_gmt":"2025-10-24T11:44:05","slug":"diagrams-as-code-meets-ai-jacqui-read-on-creating-meaningful-visualizations-with-confidence","status":"publish","type":"post","link":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/diagrams-as-code-meets-ai-jacqui-read-on-creating-meaningful-visualizations-with-confidence\/","title":{"rendered":"Diagrams-as-Code Meets AI: Jacqui Read on Creating Meaningful Visualizations with Confidence"},"content":{"rendered":"\t\t
\n\t\t\t\t
\n\t\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t\t\t\t\t

Blog<\/h2>\n\t\t\t\t\t\t\t\t\t\t\t\t

iSAQB Software Architecture Gathering 2025\u200b<\/p>\n\t\t\t\t\t\t\t\t\t\t<\/div>\n\t\t\t<\/section>\n\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t

\n\t\t\t\t\t\t
\n\t\t\t\t\t
\n\t\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t\t
\n\t\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\"Jacqui\t\t\t\t\t\t\t\t<\/a>\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/div>\n\t\t\t\t
\n\t\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t
Jacqui Read<\/a><\/h6>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t
Principal Architect, Author of Communication Patterns<\/h6>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/div>\n\t\t\t\t
\n\t\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t
\n\t\t\t\t\t\t\t\t
\n\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t<\/i>\t\t\t\t\t\t\t<\/span>\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t\t\t\t\t\t\t\t
\n\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t<\/i>\t\t\t\t\t\t\t<\/span>\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t\t\t\t\t\t\t\t
\n\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t<\/i>\t\t\t\t\t\t\t<\/span>\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t\t\t\t\t\t\t\t
\n\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t<\/i>\t\t\t\t\t\t\t<\/span>\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/section>\n\t\t\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t\t
\n\t\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t
Published on September 4, 2025<\/h6>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/section>\n\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t

Diagrams-as-Code Meets AI: Jacqui Read on Creating Meaningful Visualizations with Confidence<\/h2>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t
An interview with Jacqui Read<\/h5>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t

In anticipation of Jacqui Read's workshop, \"Diagrams-As-Code With AI\"<\/u><\/a>, Richard Wallintin (WPS - Workplace Solutions) asked her several questions about using diagrams and AI to create clear, effective visualizations.\n\n<\/a><\/p>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t

\n\t\t\t\t
\n\t\t\t\t\t

From your writing, one can conclude you are a fan of visual communication. Do you believe most people benefit from visual representation, i.e., are \u201evisual thinkers\u201c?<\/b><\/p>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t

\n\t\t\t\t
\n\t\t\t\t\t

I\u2019m a fan of any type of effective communication. There are still too many silos and gatekeepers in both tech and business, and documentation-as-an-afterthought is prevalent. When I go into an organisation, I usually have to talk to multiple people and access multiple sources of documentation to get the full picture. But it can be even worse for the people who work there, spending much of their time hunting for the information they need or constantly fielding questions from others.

\n\nVisual communication isn\u2019t just for visual learners or thinkers. Many diagrams and visuals would be harder to understand as a text, a bulleted list, or a table of data. Or they would take a lot more time and space to explain the message you want to convey.

\n \nTo select your medium for communication, you need to think about your audience and what you want them to understand and think. A table of all instances of your digital products by cloud region may show where all the instances are, but not highlight to your audience that all instances of a particular product are far away from their users geographically. A visual can show this clearly, or even be the method by which the problem was discovered.\n\n<\/p>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t

\n\t\t\t\t
\n\t\t\t\t\t

LLMs are not really thinkers, and especially not at all visual. Do they still, in your experience, produce useful visualizations? (For example, box arrangement often encodes some semantics like layers or network proximity)\n<\/b><\/p>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t

\n\t\t\t\t
\n\t\t\t\t\t

If you have at least a basic understanding of a diagrams-as-code DSL (domain-specific language, e.g., PlantUML), can write a very specific prompt, and give the LLM references to documentation, some LLMs can produce useful visualisations using diagrams-as-code. Otherwise, an LLM is likely to hallucinate or make mistakes.

\n\nI have seen plenty of examples where an LLM, such as ChatGPT, will give me a very confident answer that is absolute nonsense. This is one reason I created my Diagrams-as-code + AI training, to give people a grounding in some of the most popular diagrams-as-code notations so that they can confidently use them with AI, but also, importantly, without AI. You version control your files, and a human can edit them later.

\n\nWith LLMs changing so rapidly, it also makes my job harder to keep the training content up to date. I\u2019m looking forward to experimenting with a few of the latest models in the weeks before I give the training at SAG. It will be interesting to see if they have improved.

\n\nThere are now some tools, usually built on top of an LLM, that improve the output of the LLM by doing some of the prompt engineering for you, but you still really need to have a basic understanding of what you are doing. The educated human architect or developer is not going to go away.\n<\/p>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t

\n\t\t\t\t
\n\t\t\t\t\t

What are the major limitations and caveats when LLM-generating diagrams?<\/b><\/p>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t

\n\t\t\t\t
\n\t\t\t\t\t

This is a topic we go into deeply in Diagrams-as-code + AI. You need to know how to check the LLM\u2019s output, and you need to know how to tell the LLM specifically what to do. I show examples in my training where an LLM will hallucinate if you ask it to do something at a high level. \u201cMove box b so that it is after box d\u201d would be understood by a human, but an LLM can just hallucinate its own syntax to try to please you.

\n\nAnother key caveat is that you need to know when it will be faster to just do it yourself. This is another reason to learn at least the basics of the DSL you are using. If your prompt is long or you end up going back and forth with the LLM a few times, leaving the LLM out of the loop is going to be quicker.\n<\/p>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t

\n\t\t\t\t
\n\t\t\t\t\t

Do you have a personal favorite diagrams-as-code tool? If yes, can you pinpoint why? (or is it just taste?)<\/b><\/p>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t

\n\t\t\t\t
\n\t\t\t\t\t

When it comes to diagrams-as-code DSLs, they all have their pros and cons. There is no silver bullet or one syntax-to-rule-them-all. Some types of diagrams can be created by multiple DSLs, and some are specific to only one. This is why I cover three of the most popular DSLs, so that you can compare them, understand how they can fit into your workflow, and select one or more based on your unique situation.

\n\nThere are multiple tools that you can use with each of the DSLs, too. Some are online and free, and useful for experimenting. Some tools can be run locally, but usually take a bit of setting up. PlantUML, Mermaid, and Structurizr also have the option to use the command line, so that you can automate the output of your diagrams during your build process.

\n\nYour DSL and tool of choice will depend on your unique context. What type of diagram you want, where you want to display it, whether you need automation, whether you need multiple users, etc.<\/p>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t

\n\t\t\t\t
\n\t\t\t\t\t

Do you see any convergence towards a standard? Would that be beneficial, or should we (the trade) come up with more bold ideas?<\/b><\/p>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t

\n\t\t\t\t
\n\t\t\t\t\t

I don\u2019t think there will ever be one standard to rule them all. You get products that try to do a lot, and others that try to do one or a few things really well. Those that do a lot tend not to meet users\u2019 needs across everything. You need a suite of tools that will fit into your workflow and meet your needs.

\n\nThere may end up being high-level guidelines for diagrams-as-code, or lower-level tools that are used by more than one standard. There are a variety of rendering engines that are used by multiple DSL tools.

\n\nComparing the benefits of diagrams-as-code, diagrams, and models is an interesting part of my training. They all have their pros and cons and will be the best option for someone in some context.<\/p>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t

\n\t\t\t\t
\n\t\t\t\t\t

How does diagrams-as-code go together with collaborative modeling (joint interactive modeling with technical and not-so-technical people, typically very heavy on sticky notes)?<\/b><\/p>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t

\n\t\t\t\t
\n\t\t\t\t\t

What comes out of collaborative modeling is not the final design output. An event storm wall of sticky notes is hard for those who weren\u2019t there to understand, hard to find the bit you need (as they are usually huge), and hard to share remotely if on a physical wall. The aim of the collaborative modeling was to break down silos, get information out of people\u2019s heads, and work together to agree on a model (or at least identify where you disagree and need to work together further).

\n\nDiagrams-as-code is useful to document what came out of the collaborative session (in a way that suits version control, with clarity around what has changed), which is usually behaviour rather than structure. For behaviour, PlantUML can be used to create sequence, use case, or activity diagrams. Mermaid offers user journey, sequence, and state diagrams. You can also design the structure and use diagrams-as-code for that too, for example, with C4 or Entity Relationship diagrams.

\n\nDomain Storytelling, another collaborative method, does have a 3rd party PlantUML library available. This could be useful if you want to preserve your collaborative output, but in my experience, collaborative sessions are best done by hand, if possible. A pen allows ideas to flow much better than a digital whiteboard, diagramming tool, or diagrams-as-code. You can then document the information you need in a way your audience can understand.<\/p>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t

\n\t\t\t\t
\n\t\t\t\t\t

Learn more about Jacqui Read and her work at \"https:\/\/jacquiread.com\"<\/u><\/a>.<\/a><\/p>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t

\n\t\t\t\t
\n\t\t\t\t\t

She also shares valuable insights and articles on her blog at \"http:\/\/ministryofsoftwaredesign.com\/posts\"<\/u><\/a>.<\/a><\/p>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t

\n\t\t\t\t\t\t
\n\t\t\t\t\t
\n\t\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t
More from the speaker<\/h6>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t
\n\t\t\t\n\t\t\t\t\t\t<\/span>\n\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t

Diagrams-As-Code With AI (Workshop by Jacqui Read)<\/a><\/p>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/section>\n\t\t\t\t

\n\t\t\t\t\t\t
\n\t\t\t\t\t
\n\t\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t\t\t
\n\t\t\t\t\t\n\t\t\t\t\t\t\n\t\t\t\t\t\t\n\t\t\t\t<\/i>\t\t\t<\/span>\n\t\t\t\t\t\t\t\t\tReturn to Overview<\/span>\n\t\t\t\t\t<\/span>\n\t\t\t\t\t<\/a>\n\t\t\t\t<\/div>\n\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/div>\n\t\t\t\t
\n\t\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t
\n\t\t\t\t\t\t\t\t
\n\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t<\/i>\t\t\t\t\t\t\t<\/span>\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t\t\t\t\t\t\t\t
\n\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t<\/i>\t\t\t\t\t\t\t<\/span>\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t\t\t\t\t\t\t\t
\n\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t<\/i>\t\t\t\t\t\t\t<\/span>\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t\t\t\t\t\t\t\t
\n\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t<\/i>\t\t\t\t\t\t\t<\/span>\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/section>\n\t\t\t\t\t<\/div>\n\t\t<\/div>\n\t\t\t\t
\n\t\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\"\"\t\t\t\t\t\t\t\t<\/a>\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/section>\n\t\t\t\t<\/div>\n\t\t","protected":false},"excerpt":{"rendered":"

Jacqui Read shows how to create meaningful diagrams with Diagrams-as-Code, using AI effectively while keeping control, clarity, and collaboration at the core of software architecture.<\/p>\n","protected":false},"author":201909760,"featured_media":23791,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1364],"tags":[1487,1703,1698,1702,1693,1704,1692,1697,1695,1435,1574,1696,1700,1705,1694,1699],"post_folder":[],"yoast_head":"\nDiagrams-as-Code Meets AI: Jacqui Read on Creating Meaningful Visualizations with Confidence<\/title>\n<meta name=\"description\" content=\"Learn how Jacqui Read uses Diagrams-as-Code with AI to create clear, effective software visualizations for better collaboration and workflows.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/diagrams-as-code-meets-ai-jacqui-read-on-creating-meaningful-visualizations-with-confidence\/\" \/>\n<meta property=\"og:locale\" content=\"en_GB\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Diagrams-as-Code Meets AI: Jacqui Read on Creating Meaningful Visualizations with Confidence\" \/>\n<meta property=\"og:description\" content=\"Learn how Jacqui Read uses Diagrams-as-Code with AI to create clear, effective software visualizations for better collaboration and workflows.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/diagrams-as-code-meets-ai-jacqui-read-on-creating-meaningful-visualizations-with-confidence\/\" \/>\n<meta property=\"og:site_name\" content=\"Software Architecture Gathering 2026\" \/>\n<meta property=\"article:published_time\" content=\"2025-09-04T08:00:00+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2025-10-24T11:44:05+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/conferences.isaqb.org\/wp-content\/uploads\/2025\/09\/SAG-2025-Interview-Read-WP-d2.jpg\" \/>\n\t<meta property=\"og:image:width\" content=\"1200\" \/>\n\t<meta property=\"og:image:height\" content=\"675\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/jpeg\" \/>\n<meta name=\"author\" content=\"Madlen Schenk\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:title\" content=\"Diagrams-as-Code Meets AI: Jacqui Read on Creating Meaningful Visualizations with Confidence\" \/>\n<meta name=\"twitter:description\" content=\"Learn how Jacqui Read uses Diagrams-as-Code with AI to create clear, effective software visualizations for better collaboration and workflows.\" \/>\n<meta name=\"twitter:image\" content=\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/wp-content\/uploads\/2025\/09\/SAG-2025-Interview-Read-WP-d2.jpg\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Madlen Schenk\" \/>\n\t<meta name=\"twitter:label2\" content=\"Estimated reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"7 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/diagrams-as-code-meets-ai-jacqui-read-on-creating-meaningful-visualizations-with-confidence\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/diagrams-as-code-meets-ai-jacqui-read-on-creating-meaningful-visualizations-with-confidence\/\"},\"author\":{\"name\":\"Madlen Schenk\",\"@id\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/#\/schema\/person\/6e1a84159b2d354efc741d2fbc8c3eb1\"},\"headline\":\"Diagrams-as-Code Meets AI: Jacqui Read on Creating Meaningful Visualizations with Confidence\",\"datePublished\":\"2025-09-04T08:00:00+00:00\",\"dateModified\":\"2025-10-24T11:44:05+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/diagrams-as-code-meets-ai-jacqui-read-on-creating-meaningful-visualizations-with-confidence\/\"},\"wordCount\":1371,\"publisher\":{\"@id\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/#organization\"},\"image\":{\"@id\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/diagrams-as-code-meets-ai-jacqui-read-on-creating-meaningful-visualizations-with-confidence\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/wp-content\/uploads\/2025\/09\/SAG-2025-Interview-Read-WP-d2.jpg\",\"keywords\":[\"AI\",\"C4 model\",\"collaborative modeling\",\"diagrams\",\"Diagrams-as-Code\",\"domain-specific language\",\"Jacqui Read\",\"Mermaid\",\"PlantUML\",\"software architecture\",\"software design\",\"Structurizr\",\"technical documentation\",\"version control\",\"visual communication\",\"workflow automation\"],\"articleSection\":[\"Blog\"],\"inLanguage\":\"en-GB\"},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/diagrams-as-code-meets-ai-jacqui-read-on-creating-meaningful-visualizations-with-confidence\/\",\"url\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/diagrams-as-code-meets-ai-jacqui-read-on-creating-meaningful-visualizations-with-confidence\/\",\"name\":\"Diagrams-as-Code Meets AI: Jacqui Read on Creating Meaningful Visualizations with Confidence\",\"isPartOf\":{\"@id\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/diagrams-as-code-meets-ai-jacqui-read-on-creating-meaningful-visualizations-with-confidence\/#primaryimage\"},\"image\":{\"@id\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/diagrams-as-code-meets-ai-jacqui-read-on-creating-meaningful-visualizations-with-confidence\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/wp-content\/uploads\/2025\/09\/SAG-2025-Interview-Read-WP-d2.jpg\",\"datePublished\":\"2025-09-04T08:00:00+00:00\",\"dateModified\":\"2025-10-24T11:44:05+00:00\",\"description\":\"Learn how Jacqui Read uses Diagrams-as-Code with AI to create clear, effective software visualizations for better collaboration and workflows.\",\"breadcrumb\":{\"@id\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/diagrams-as-code-meets-ai-jacqui-read-on-creating-meaningful-visualizations-with-confidence\/#breadcrumb\"},\"inLanguage\":\"en-GB\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/diagrams-as-code-meets-ai-jacqui-read-on-creating-meaningful-visualizations-with-confidence\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-GB\",\"@id\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/diagrams-as-code-meets-ai-jacqui-read-on-creating-meaningful-visualizations-with-confidence\/#primaryimage\",\"url\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/wp-content\/uploads\/2025\/09\/SAG-2025-Interview-Read-WP-d2.jpg\",\"contentUrl\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/wp-content\/uploads\/2025\/09\/SAG-2025-Interview-Read-WP-d2.jpg\",\"width\":1200,\"height\":675,\"caption\":\"SAG-2025-Interview-Read\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/diagrams-as-code-meets-ai-jacqui-read-on-creating-meaningful-visualizations-with-confidence\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Diagrams-as-Code Meets AI: Jacqui Read on Creating Meaningful Visualizations with Confidence\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/#website\",\"url\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/\",\"name\":\"Software Architecture Gathering 2026\",\"description\":\"The Global Conference for Software Architecture\",\"publisher\":{\"@id\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-GB\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/#organization\",\"name\":\"Software Architecture Gathering 2026\",\"url\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-GB\",\"@id\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/wp-content\/uploads\/2024\/02\/SAG-Logo-2024-rgb-500x170-transparent.png\",\"contentUrl\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/wp-content\/uploads\/2024\/02\/SAG-Logo-2024-rgb-500x170-transparent.png\",\"width\":500,\"height\":169,\"caption\":\"Software Architecture Gathering 2026\"},\"image\":{\"@id\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/#\/schema\/logo\/image\/\"}},{\"@type\":\"Person\",\"@id\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/#\/schema\/person\/6e1a84159b2d354efc741d2fbc8c3eb1\",\"name\":\"Madlen Schenk\",\"url\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/author\/mschenkisaqb-org\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Diagrams-as-Code Meets AI: Jacqui Read on Creating Meaningful Visualizations with Confidence","description":"Learn how Jacqui Read uses Diagrams-as-Code with AI to create clear, effective software visualizations for better collaboration and workflows.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/diagrams-as-code-meets-ai-jacqui-read-on-creating-meaningful-visualizations-with-confidence\/","og_locale":"en_GB","og_type":"article","og_title":"Diagrams-as-Code Meets AI: Jacqui Read on Creating Meaningful Visualizations with Confidence","og_description":"Learn how Jacqui Read uses Diagrams-as-Code with AI to create clear, effective software visualizations for better collaboration and workflows.","og_url":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/diagrams-as-code-meets-ai-jacqui-read-on-creating-meaningful-visualizations-with-confidence\/","og_site_name":"Software Architecture Gathering 2026","article_published_time":"2025-09-04T08:00:00+00:00","article_modified_time":"2025-10-24T11:44:05+00:00","og_image":[{"width":1200,"height":675,"url":"https:\/\/conferences.isaqb.org\/wp-content\/uploads\/2025\/09\/SAG-2025-Interview-Read-WP-d2.jpg","type":"image\/jpeg"}],"author":"Madlen Schenk","twitter_card":"summary_large_image","twitter_title":"Diagrams-as-Code Meets AI: Jacqui Read on Creating Meaningful Visualizations with Confidence","twitter_description":"Learn how Jacqui Read uses Diagrams-as-Code with AI to create clear, effective software visualizations for better collaboration and workflows.","twitter_image":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/wp-content\/uploads\/2025\/09\/SAG-2025-Interview-Read-WP-d2.jpg","twitter_misc":{"Written by":"Madlen Schenk","Estimated reading time":"7 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/diagrams-as-code-meets-ai-jacqui-read-on-creating-meaningful-visualizations-with-confidence\/#article","isPartOf":{"@id":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/diagrams-as-code-meets-ai-jacqui-read-on-creating-meaningful-visualizations-with-confidence\/"},"author":{"name":"Madlen Schenk","@id":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/#\/schema\/person\/6e1a84159b2d354efc741d2fbc8c3eb1"},"headline":"Diagrams-as-Code Meets AI: Jacqui Read on Creating Meaningful Visualizations with Confidence","datePublished":"2025-09-04T08:00:00+00:00","dateModified":"2025-10-24T11:44:05+00:00","mainEntityOfPage":{"@id":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/diagrams-as-code-meets-ai-jacqui-read-on-creating-meaningful-visualizations-with-confidence\/"},"wordCount":1371,"publisher":{"@id":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/#organization"},"image":{"@id":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/diagrams-as-code-meets-ai-jacqui-read-on-creating-meaningful-visualizations-with-confidence\/#primaryimage"},"thumbnailUrl":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/wp-content\/uploads\/2025\/09\/SAG-2025-Interview-Read-WP-d2.jpg","keywords":["AI","C4 model","collaborative modeling","diagrams","Diagrams-as-Code","domain-specific language","Jacqui Read","Mermaid","PlantUML","software architecture","software design","Structurizr","technical documentation","version control","visual communication","workflow automation"],"articleSection":["Blog"],"inLanguage":"en-GB"},{"@type":"WebPage","@id":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/diagrams-as-code-meets-ai-jacqui-read-on-creating-meaningful-visualizations-with-confidence\/","url":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/diagrams-as-code-meets-ai-jacqui-read-on-creating-meaningful-visualizations-with-confidence\/","name":"Diagrams-as-Code Meets AI: Jacqui Read on Creating Meaningful Visualizations with Confidence","isPartOf":{"@id":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/#website"},"primaryImageOfPage":{"@id":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/diagrams-as-code-meets-ai-jacqui-read-on-creating-meaningful-visualizations-with-confidence\/#primaryimage"},"image":{"@id":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/diagrams-as-code-meets-ai-jacqui-read-on-creating-meaningful-visualizations-with-confidence\/#primaryimage"},"thumbnailUrl":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/wp-content\/uploads\/2025\/09\/SAG-2025-Interview-Read-WP-d2.jpg","datePublished":"2025-09-04T08:00:00+00:00","dateModified":"2025-10-24T11:44:05+00:00","description":"Learn how Jacqui Read uses Diagrams-as-Code with AI to create clear, effective software visualizations for better collaboration and workflows.","breadcrumb":{"@id":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/diagrams-as-code-meets-ai-jacqui-read-on-creating-meaningful-visualizations-with-confidence\/#breadcrumb"},"inLanguage":"en-GB","potentialAction":[{"@type":"ReadAction","target":["https:\/\/conferences.isaqb.org\/software-architecture-gathering\/diagrams-as-code-meets-ai-jacqui-read-on-creating-meaningful-visualizations-with-confidence\/"]}]},{"@type":"ImageObject","inLanguage":"en-GB","@id":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/diagrams-as-code-meets-ai-jacqui-read-on-creating-meaningful-visualizations-with-confidence\/#primaryimage","url":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/wp-content\/uploads\/2025\/09\/SAG-2025-Interview-Read-WP-d2.jpg","contentUrl":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/wp-content\/uploads\/2025\/09\/SAG-2025-Interview-Read-WP-d2.jpg","width":1200,"height":675,"caption":"SAG-2025-Interview-Read"},{"@type":"BreadcrumbList","@id":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/diagrams-as-code-meets-ai-jacqui-read-on-creating-meaningful-visualizations-with-confidence\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/"},{"@type":"ListItem","position":2,"name":"Diagrams-as-Code Meets AI: Jacqui Read on Creating Meaningful Visualizations with Confidence"}]},{"@type":"WebSite","@id":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/#website","url":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/","name":"Software Architecture Gathering 2026","description":"The Global Conference for Software Architecture","publisher":{"@id":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-GB"},{"@type":"Organization","@id":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/#organization","name":"Software Architecture Gathering 2026","url":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/","logo":{"@type":"ImageObject","inLanguage":"en-GB","@id":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/#\/schema\/logo\/image\/","url":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/wp-content\/uploads\/2024\/02\/SAG-Logo-2024-rgb-500x170-transparent.png","contentUrl":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/wp-content\/uploads\/2024\/02\/SAG-Logo-2024-rgb-500x170-transparent.png","width":500,"height":169,"caption":"Software Architecture Gathering 2026"},"image":{"@id":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/#\/schema\/logo\/image\/"}},{"@type":"Person","@id":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/#\/schema\/person\/6e1a84159b2d354efc741d2fbc8c3eb1","name":"Madlen Schenk","url":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/author\/mschenkisaqb-org\/"}]}},"_links":{"self":[{"href":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/wp-json\/wp\/v2\/posts\/23740"}],"collection":[{"href":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/wp-json\/wp\/v2\/users\/201909760"}],"replies":[{"embeddable":true,"href":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/wp-json\/wp\/v2\/comments?post=23740"}],"version-history":[{"count":45,"href":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/wp-json\/wp\/v2\/posts\/23740\/revisions"}],"predecessor-version":[{"id":24095,"href":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/wp-json\/wp\/v2\/posts\/23740\/revisions\/24095"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/wp-json\/wp\/v2\/media\/23791"}],"wp:attachment":[{"href":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/wp-json\/wp\/v2\/media?parent=23740"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/wp-json\/wp\/v2\/categories?post=23740"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/wp-json\/wp\/v2\/tags?post=23740"},{"taxonomy":"post_folder","embeddable":true,"href":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/wp-json\/wp\/v2\/post_folder?post=23740"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}