The floor plan behind the experience

A building’s visitors see rooms, doors, and signs. Behind that experience are structural choices about foundations, plumbing, power, and fire safety that most visitors would not need to consider. Software also needs an internal plan for how its parts work together.

Technical design might show what runs in a user’s browser or app, what runs on remote servers, where data is stored, and how an API connects the parts. It also explains what existing source code will change and how the team will handle failures.

Technical design often covers one piece of work. Architecture covers the wider structure and decisions that shape many features. Teams record both the decisions and their reasons, often in text and diagrams, so future colleagues understand why the system works as it does.

Design is about trade-offs

There is rarely one objectively perfect design. A team balances speed, cost, security, reliability, flexibility, and the complexity of operating the result. A solution that is sensible for a small experiment may be unsuitable for a service used by millions of people.

Non-technical colleagues help by making priorities and constraints explicit. “This feature must launch next week” and “this system must never lose a payment” lead to different trade-offs. Ask which assumptions need testing, what decisions will be hard to change later, and how the team will know if the design works as intended in production.