ArchitectureConference50min
AI vs architecture diagrams
This session examines why AI-generated software architecture diagrams often fail, highlighting common issues and their root causes. It offers practical guidance on improving diagram quality and leveraging AI tools effectively to support, rather than replace, human design and documentation expertise.
talk.summaryAiDisclaimer
Simon Brown
talkDetail.whenAndWhere
Friday, June 19, 11:40-12:30
Room 2
talks.roomOccupancytalks.noOccupancyInfo
The appetite for generating software architecture diagrams with AI is undeniable, with use cases ranging from solution creation through to documenting existing codebases. Social media is awash with stories where an AI agent has generated diagrams, with most authors claiming that the AI has done "a good job". This generally isn't true though - almost every software architecture diagram I've seen generated by AI is terrible! In this session I'll explain the common problems I see with AI-generated software architecture diagrams, how to fix them, and how to get better results from your AI agent if you do want to use it as a tool to assist with diagram generation.
Simon Brown
Simon is an independent consultant specialising in software architecture. He is the author of “Software Architecture for Developers” (a developer-friendly guide to software architecture, technical leadership and the balance with agility), the creator of the C4 model for visualising software architecture, and the creator of the Structurizr tooling. Simon is a regular speaker at international software development conferences, and travels the world to help organisations visualise their software architecture.