A glowing amber arc sweeping from dense dark legacy structures on the left to clean luminous modern forms on the right against deep indigo space.
prompt · “A sweeping amber arc rising from dense layered legacy structures on the left to clean precise modern forms on the right — the transformation itself.”
— NanoBanana
← Back to feed
Constellation Building

The Modernisation Arc

From constraint philosophy to a unified monorepo — the principles, the proof points, and the implementation details of modernising a legacy platform.

6 signals
—
THOUGHT

Architecture is constraint management, not technology selection. The question is never 'what is best?' — it's 'what is possible given our constraints?'

Every modernisation story starts with a constraint. Not a grand vision. Not a new technology. A wall you hit so many times that you finally stop and redesign the path around it.

the scale
NUMBER
100+
.NET projects unified into a single monorepo
philosophy deepens
THOUGHT

Legacy modernisation isn't a technical project — it's a risk management operation. The discipline is designing every step to be reversible before you take it.

The number tells one story — scale. But scale alone doesn't explain why the approach worked. The philosophy had to come first.

the implementation
WRITE
When Git Submodules Make Sense in a Monorepo

The textbook answer is always a full monorepo merge. But in large codebases with independent release cadences, the right answer is often a stepping stone — and submodules can be that stepping stone.

Implementation answers how. But a modernisation needs a where — a north star that every incremental step points toward.

the north star
WRITE
What a Twenty-Year-Old Codebase Could Become

The architectural north star worth holding when a monolith has outlived its original design.
principles distilled
WRITE
Constraint-Driven Architecture: Five Principles for Building in the Real World

Architecture advice assumes you start fresh. You never do. Here are five principles for designing software when constraints are the starting point, not an afterthought.

With the vision documented and the implementation details proven, the final step was distilling what we learned into transferable principles.