Tagged with maintainability

Browse all tags

AI Coding Still Needs Architecture

AI coding tools make architecture more important, not less important. Learn why I give AI agents an ARCHITECTURE.md file before asking them to write code.

When Is Architecture Actually Overkill?

Learn how to reason about architecture overkill, adapters, dependency inversion, and boundaries in large Swift apps.

Architecture Decisions I Would Avoid in a New SwiftUI App

Learn architecture decisions to avoid in new SwiftUI apps, from global state to over-abstracted networking and hidden dependencies.

How to Refactor Toward Better Architecture Without Rewriting the App

Learn how to refactor an iOS feature toward better architecture gradually, without rewriting the whole app.

Testing Architecture, Not Implementation Details

Learn how to test architecture in Swift by focusing on behavior, boundaries, contracts, and meaningful composition.

Naming Protocols and Implementations in Swift

Practical naming advice for Swift protocols and implementations: avoid Protocol, Impl, Manager, and vague abstractions.

What Makes Good Software Architecture?

A practical definition of good software architecture: change-friendly, testable, maintainable, and useful to the team.