Get in touch

Fill out this form and our team will respond as soon as we can, alternatively email us at mail@icepanel.io.

The IcePanel Loop

The way software is built is changing. Yet, architecture thinking is more important than ever. This is our simple view on progressive architecture.

Context

The Shift

The Shift

Software systems are more complex than ever, and AI is adding fuel to the fire. The role of architects is changing. Diagrams and code that took hours to produce are now generated in seconds. The dream of automated architecture diagrams from code feels close to reality. However, faster output doesn't mean better architecture. Quantity and quality don't always go hand in hand. In fact, AI can sometimes create more complexity and uncertainty for teams, especially at scale.

The current approach to software architecture isn't equipped to deal with today's complexity. It's outdated, siloed, and slow to adapt to new requirements. The current tools for software architecture suck. They lack depth, clarity, and opportunity for collaboration when designing systems. Rarely do these tools feel fun and enjoyable to use.

Architecture isn't something that only architects should care about. It's soon going to be a baseline expectation for anyone involved in product building. Architecture needs to evolve as fast as the businesses it supports.

The bottleneck is no longer writing code, and honestly, it never has been.

Architects and product builders in general face many challenges when designing software. Coming up with ideas is easy. But without a clear hypothesis for the value proposition and an understanding of current constraints, ideas can't be validated. They're just assumptions about the architecture. If the architecture doesn't reflect the reality of the system, it becomes hard to turn assumptions into tested decisions.

Product builders face challenges like:

Understanding existing systems and business context

Statements like 'It just works' or 'TODO: add a diagram' won't cut it. Architecture isn't designed in a void. It's designed in a world of interconnected systems, each with inputs, outputs, and feedback loops. That's what Donella Meadows called "Thinking in Systems". Customers are systems. AI agents acting on behalf of users are systems. The more context we have, from business to technical, the better we design systems that actually work together.

Aligning teams

Designing architecture is one thing. Getting stakeholders behind the architectural decisions is another thing. Aligning teams can be challenging if the problem isn't communicated clearly up front. Alignment comes from discussing ideas, trade-offs, and reaching consensus. Just as important is making sure teams work from a stable foundation of knowledge and a language for talking about their systems. How many times have you seen people refer to systems as different things?

Making the right decisions

Architectural decisions can be expensive and sometimes irreversible. Product builders should deeply understand the problems they're trying to solve in order to make the right decisions. Without a deep understanding of the root cause, even well-intentioned decisions can waste months of a company's time. Jeff Bezos distinguished between two types of decisions at Amazon: Type 1: Irreversible with long-term consequences like choosing a cloud provider, enterprise resource planning (ERP), or a database solution. Type 2: Reversible with short-term consequences like building prototypes or a minimum viable product (MVP).

Building the right thing

Sounds cliché, but it's true. Many teams end up building the wrong thing. This could be misguided product direction, not aligning on decisions, or building on inconsistent architecture. Now with AI, building is no longer the bottleneck. Knowing what problems to solve and how to solve them is.

Pivoting when needed

In a perfect world where all requirements are available upfront and customer needs never change, we wouldn't need to change or revise our architecture. As much as we want this to be true, that's not the case. Even more so today. Learning how and when to pivot is both a challenge and a critical skill for product builders.

Architecture is foundational to all software we use. But the way we've been doing it isn't working. Treating diagrams as set-and-forget won't work in modern architectures. Diagrams are just one view of the model, a visual representation that helps humans reason about complex systems. But the model itself is what matters. AI doesn't need a diagram to understand your architecture. It needs the model. Legacy codebases are inevitably maintained. The models that represent them should be too.

Architecture is dead, long live architecture

Every builder starts with an idea. They get together and start designing their architecture on a whiteboard. They draw initial abstractions, unlabelled connections, and write partial explanations of components. They see their diagram as 'good enough' to build, and start developing it without reviewing the whiteboard. In that scenario, architecture is treated like a throwaway artefact, left to die. This version of architecture is dead.

Static diagrams, big upfront design or no design at all, documentation as an output, and architects as gatekeepers. These are all symptoms of old architecture. They do not keep up with the world's pace, especially with AI.

Architecture is dead, long live architecture

We don't see architecture as an end goal. It's something built on iteratively and always evolving.

Long live architecture.

Ticketmaster context

The new version of architecture is:

Continuous

It evolves as you learn. New requirements or customer use cases will always come up, and systems are ever changing. There's no such thing as 'done'.

Collaborative

Product, engineering, and design have responsibilities toward architecture. Architecture becomes decentralized in an organization. Communication is now a core skill and the language architects need to use needs to change based on the audience.

Evolutionary

Architecture evolves to adapt to new product direction, business needs, and customer requirements. Systems can't just be designed for the current state, they need to be built with the future in mind, which is uncertain.

Decision-first

We're not documenting for the sake of documenting. We're capturing design decisions, deliberate choices that reflect how architecture should behave under certain conditions. Not a wiki page for engineers, but a critical reference for making future decisions. Good and bad decisions compound.

Old world New world
Static diagrams Big upfront or no design Documentation as output Architects as gatekeepers Continuous Collaborative Evolutionary Decision-first

Architecture is not about creating one-time documentation. It's a collaborative practice where architects and product builders review design decisions and build on them. To get there, we define a simple set of principles.

Principles

IcePanel principles

Start simple

Simplicity wins, always. Whether in software development or architecture design. We believe every architecture starts simple and evolves only when necessary. Not the other way around. Modern systems are complex by nature. That's expected. What's not acceptable is the unnecessary complexity that we introduce. For example, rarely do teams design complete products from day one. Amazon didn't start as a global e-commerce system. It started by selling books online. Slack didn't start as a global communication platform. It started as an internal tool inside a gaming company.

We believe in designing systems with the intention to simplify, just enough to move forward while still delivering value.

Product ideas go through multiple iterations (i.e., pivots) before reaching product-market fit. Architecture follows a similar journey. It starts simple and is continuously refined to reach architecture-market fit. Building the right technical system for the right audience.

Design for movement

Our premise is that architecture is the structure of dynamic systems. Relying on static diagrams only gives you a snapshot in time, and who knows when that snapshot was taken. That's why we design for movement. Architecture is not about getting it right up front. It's about making progress, adapting to new learnings, and evolving through use, not speculation. Like UI and product design, architecture should adapt to new requirements and real-world use.

Designs are meant to be examined and revised, which is why a visual model built for change can follow you through that process. Businesses need architecture to solve what matters right now (not even tomorrow). It evolves as we learn and isn't a waterfall approach.

Audience first

Modern architecture should be communicated to and accessible by its audience: product, design, engineering, and increasingly, AI agents. It only matters if it's understood, which requires different views for different audiences. Humans reason through diagrams. AI reasons through the model and code. Gatekeeping doesn't work here. Shared understanding beats perfect documentation. Architects, product managers, designers, and software engineers are all product builders. Designs need to serve product builders.

Collaborate

We believe in collaboration. Architecture is not owned by architects. It is a shared responsibility across all teams. Architecture should be a collaborative space for design and decision-making. We model from the ground up, generate views for different use cases, and create contextualised diagrams when needed. Even if collaboration takes time and effort, it's an upfront investment that makes architecture a reflection of reality, not a lag behind it.

The best architecture comes from aligned teams, not isolated silos. These principles describe what we believe. The IcePanel Loop is how we put them into practice.

The Loop

The IcePanel Loop

We believe architecture is a loop, not a phase. Most teams treat architecture as something you do once at the start of a project and never revisit. But systems change. Businesses change. People change. Architecture needs to keep up.

We think of the IcePanel loop as 4 continuous steps: Define, Visualise, Validate, and Adapt.

The IcePanel Loop

Define

Start by identifying what you want to build and why. Before implementing a solution or designing any architecture, understand the surrounding business context, technical constraints, and clarify the problem you're solving. The goal is to answer the question: "What does this system need to do, and for whom?"

Modelling intent is a strong starting point. It makes the "why" crystal clear to everyone, so every decision that follows can be traced back to it.

Visualise

Take the intent you've modelled and represent it in a way that others can see and question. Visualising the system answers two key questions: how does it work today, how did it work before?

This isn't about generating pretty diagrams. It's about surfacing the current state of the system and presenting the required context for teams to make decisions about the future. Use a tool that's flexible enough to speak to every audience.

Validate

Share the model with stakeholders. Engineers, product managers, leadership, and agents, should all be looking at the same system. Validating the model is about answering: how should it work, how does it work, and how could it work? The goal is to build alignment, create shared understanding, ideate, and make deliberate decisions.

Adapt

Adaptation is about figuring out how the new model will work. Requirements always change, so we'll need to update the model to reflect reality, record what was decided and why, then loop back to intent. You don't want to be drowning in manual work, so aim to find solutions that don't get in the way and are there when you need them.

Every iteration of these four steps improves the overall architecture. This loop closes the gap between intent and reality. If we're not collectively incorporating architectural decisions, we're just wishful thinkers.

The future

Tip of the iceberg

Tip of the iceberg

Humans are visual thinkers. Diagrams help us explain the architecture, highlight some intricacies, and reason about systems. But diagrams are only the tip of the iceberg.

Beneath the surface lives the real architecture: dependencies, data models, integrations, and design trade-offs. Without this depth, diagrams are just pretty pictures, and tools are only good at generating pictures.

Our job as architects is to see the whole iceberg and make it visible and approachable. We believe in problem breakdown, context gathering, collaboration, and design for movement.

Systems can't be fully understood from a single view. Most diagrams only show high-level components, not enough to collaborate meaningfully on design trade-offs. Tools should be designed to give you the full picture through layered hierarchies, from high-level systems down to components and code. Full transparency leads to better collaboration. No gatekeeping on architectural decisions. Every layer of the iceberg should be visible, designable, and open to collaboration.

Future of architecture with AI

AI is not replacing human architects. The internet thinks that software engineers are no longer needed, yet companies (especially startups) are hiring them aggressively.

AI redefines the role but doesn't change the need.

Going back to our main premise: AI is changing how we design and build software. The role of the architect is evolving from someone who writes every design document to someone who manages and guides what AI produces. AI can drastically speed us up, but if used incorrectly or without a strong understanding, the pain can compound fast.

AI is great at generating code, diagrams, and infrastructure templates. The architect has to make sure the systems being generated actually make sense together in practice and at scale. The skill of architecture translating context up and down layers in the organization will be more important than ever.

The future of architecture is less one sided. Instead, we see both automation and humans being part of the loop. Automated systems using LLMs to feed in information on how things work into a source of truth (e.g. cloud providers, telemetry tooling, code, etc.), with humans monitoring and communicating how things work from their perspective.

Agents are coming

AI is evolving from "assistant" tools to autonomous agents, also known as agentic workflows. The crux is that AI agents can gather context, call APIs, and make some decisions on behalf of users. There's no denying how powerful agents have already become.

Agentic workflows will change the future of software development and further elevate the importance of architecture. We're used to designing systems for humans clicking through interfaces, but now we need to account for non-human users. The challenge today has shifted to gathering context. AI can't replace this. Inferring from the codebase can be a slippery slope because it reflects what was done, not what was planned nor what you want to do. It misses the learnings.

Architects need to design for this new world, including how agents flow through their systems. How will systems be able to handle millions of requests concurrently from humans and agents? How will systems be secure from black hat (malicious) agents? We're already entering this new world, and our principles hold strong. Start simple, design for movement, audience first, and collaborate.

Final thoughts

Software architecture is here to stay, with or without AI. Every day, new systems are designed and deployed, and there will always be a need to review and evolve them. Without architecture, it becomes nearly impossible for the teams and businesses that depend on these systems.

AI is changing our roles as architects. We don't know exactly what the future looks like. Nobody does. But one thing is clear: As systems become faster to build, they become harder to maintain. Shared responsibility fixes it, rooted in the four principles we covered.

Architecture is no longer about controlling complexity upfront. It's about reviewing and refining continuously, just like a loop. That's the IcePanel Loop.

References

Our method might sound familiar. It is inspired by many thought leaders in software architecture. There are many to mention… but here are a few:

Reference Core idea
Agile Manifesto Responding to change over following a plan
Lean Software Development - Mary & Tom Poppendieck Eliminate waste, amplify learning
Continuous delivery - Jez Humble, Dave Farley Systems must evolve safely and continuously
C4 Model - Simon Brown Hierarchical, audience-driven views
Evolutionary Architecture - Neal Ford, Rebecca Parsons, Patrick Kua Architecture evolves guided by fitness functions
Domain-Driven Design (DDD) - Eric Evans, Vaughn Vernon Align software with business understanding
Event Storming - Alberto Brandolini Collaborative modelling through workshops
Wardley Mapping - Simon Wardley Map systems based on evolution and value chain
Team Topologies - Matthew Skelton, Manuel Pais Architecture emerges from team structure
Systems Thinking – Donella Meadows, Peter Senge Systems are dynamic, interconnected, evolving
DevOps Break down silos, continuous collaboration
Model-Driven Development Models as primary artifacts, code derived from them
Observability & Runtime Thinking Understand systems in real time
AI-Native Development Prompt → generate → evaluate → refine
UX / Design Thinking Learn, define, prototype, test, iterate, repeat

Crafted by The IcePanel Team — Shehab (writer), Oliver (designer), Tim (editor), Jacob (ideation and editor)

Is IcePanel for your team?

Try it out for free and see what you think.

Stay chill

Get in touch

Fill out this form and our team will respond as soon as we can, alternatively email us at mail@icepanel.io.